GitHub Projects 怎样用自定义字段筛选迭代任务

GitHub Projects 里要按迭代查看任务，关键不是给标题加关键词，而是先让任务拥有可筛选的 Iteration 字段，再在项目视图的筛选栏输入字段条件。最常用的过滤写法是 iteration:@current；如果要看指定周期，可以改成 iteration:"Sprint 12"，也可以与状态、负责人等条件组合。

官方地址：https://docs.github.com/en/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects

先把任务的 Iteration 值填完整，再筛选；如果结果为空，优先检查字段是否为空、迭代名称是否写对，以及当前项目视图是否包含这些任务。

步骤一：进入项目并切换到表格视图

打开目标 Project，在视图标签中选择 Table。表格视图适合一次检查任务标题、状态、负责人和 Iteration 等列，也方便确认字段值是否漏填。进入后先观察顶部工具栏，筛选入口通常位于视图工具区域；如果窗口较窄，部分按钮会收进更多操作菜单。

操作路径：Project → 目标视图 → Layout → Table。确认成功的状态是：任务按行显示，表头能看到字段列，并且工具栏出现筛选输入入口。不要一开始就用全局搜索框，它搜索的是项目页面内容，不能替代视图字段筛选。

步骤二：创建或确认 Iteration 字段

在项目表头右侧打开字段菜单，选择新增字段，并将类型设为 Iteration。根据团队节奏设置每个迭代的长度和开始日期；如果项目已经有 Iteration 列，不要重复创建同名字段，直接进入下一步。

操作路径：表头字段菜单 → New field → Iteration → 设置周期 → 保存。成功状态是表头出现 Iteration，单元格可以打开选项列表。Iteration 适合表示按周或按周期推进的任务；优先级、模块、风险等级等离散属性应分别使用 Single select 字段，不要把它们混在同一个迭代字段里。

步骤三：为任务填写迭代值

回到任务表格，定位 Iteration 列。点击某行的空单元格，选择当前迭代；对已经排入后续计划的任务选择未来迭代。批量检查时，建议先按 Status 或负责人排序，再逐行核对，避免把同名任务误分到不同周期。

操作路径：任务行 → Iteration 单元格 → 选择当前或指定迭代。成功状态是每个目标任务的 Iteration 列显示相同的周期名称。空值不是“未开始”的另一种写法，它表示该任务还没有迭代归属；如果团队需要表达未排期，应保留空值并在视图中单独使用 no:iteration 检查。

步骤四：用筛选栏过滤当前迭代

点击视图顶部的筛选入口，输入 iteration:@current，从建议项中确认字段后提交。这个写法按当前迭代解析，不必每次改成具体名称。需要锁定某一周期时，使用 iteration:"Sprint 12"；需要覆盖当前和接下来几个周期，可以使用迭代范围语法。

还可以组合条件，例如 iteration:@current status:"In progress" assignee:@me，表示当前迭代中、状态为进行中且分配给自己的任务。GitHub Projects 的多个筛选条件默认是 AND；同一字段用逗号分隔多个值时才表示该字段内的 OR。成功状态是列表只留下符合条件的任务，筛选条中能看到已生效的条件。

步骤五：保存视图并核对筛选边界

确认结果后，打开视图菜单选择复制或保存为新视图，使用“当前迭代任务”之类能表达范围的名称。保存前先做三项核对：有值任务是否都在预期周期、空 Iteration 任务是否被排除、未来迭代是否因为范围条件被误纳入。

重新打开保存的视图后，筛选条件仍然存在且任务数量稳定，就说明这条路径已经可复用。若结果突然变少，先检查任务是否被移出项目、Iteration 周期是否滚动，以及状态字段的实际选项名称是否发生变化。

常见问题

为什么筛选栏输入 iteration 后没有结果？

先检查任务行的 Iteration 是否为空，再确认筛选值使用的是项目中的周期名称或 @current 关键字。只在标题中写“Sprint 12”不会产生字段值。

可以同时筛选两个迭代吗？

可以对同一字段使用逗号分隔的多个值，或使用迭代范围。范围筛选更适合连续周期，离散周期则优先使用明确的字段值。

为什么同一条任务在不同视图里显示不一样？

视图可以保存不同布局、筛选和排序。先查看当前视图顶部的筛选条件，再确认任务仍属于该 Project；视图差异不一定表示任务数据丢失。

这套方法的判断顺序可以固定为：先确认字段存在，再补齐任务值，最后用筛选条件和保存视图复用结果。这样排查时能区分“字段没有值”和“筛选语法不匹配”，也不会把普通文本搜索误当成项目字段过滤。