GitHub分支保护中指定状态检查项不显示的问题求助

确保任务在PR场景下实际生成过状态检查记录 #

GitHub的必填状态检查列表只会展示在拉取请求中实际运行过的任务对应的标识。你之前看到的是PR合并后或手动触发的运行，这些场景和PR打开/代码推送时的场景不同：

• 新建一个测试PR，或者在现有PR上推送一次代码，触发工作流完整执行，确保tests-done任务出现在该PR的检查记录里
• 运行完成后，再回到仓库「Settings → Branches → Branch protection rules」页面搜索任务名称

修正配置中的拼写错误 #

你的配置里有个明显错误：needs.tests.result应该是needs.test.result（依赖的任务是test，不是tests）。这个错误会导致Failure步骤无法正确触发，甚至可能让整个任务状态异常，无法被GitHub识别为有效状态检查项。修正后的配置：

tests-done:
  name: Finished Tests
  needs: test
  steps:
    - name: Success
      if: needs.test.result == 'success'
      run: echo "Success!"
    - name: Failure
      if: needs.test.result != 'success'
      run: exit 1

确认工作流触发规则覆盖PR场景 #

检查工作流的on配置是否同时包含pull_request和push，且没有额外条件过滤PR场景的运行：

on:
  push:
    branches: ["**"]
  pull_request:
    branches: ["**"]

如果工作流在PR打开时没被触发，tests-done就不会生成状态检查记录，自然无法在设置中找到。

排查任务的全局运行条件 #

如果tests-done任务本身有全局if条件，可能导致它在PR场景下不运行，比如：

tests-done:
  name: Finished Tests
  needs: test
  if: github.event_name == 'push' # 这类条件会限制PR场景的运行
  steps:
    # ...

确保没有这类限制PR场景的全局条件。

刷新页面或清除缓存 #

有时候GitHub页面缓存会导致状态检查列表未及时更新，尝试刷新设置页面，或者用无痕模式打开页面再搜索任务名称。

内容的提问来源于stack exchange，提问作者keik