GitHub Actions dev分支工作流不显示问题咨询

• 检查工作流触发规则
  打开dev分支下的ci.yml，确认on字段的分支配置是否包含dev。很多默认生成的工作流会只绑定main分支，比如：

  on:
    push:
      branches: [ "main" ]
  

  如果dev不在分支列表里，工作流不会触发。可以修改为包含dev的配置，比如：

  on:
    push:
      branches: [ "main", "dev" ]
  

  同时注意有没有反向排除规则（branches-ignore）不小心把dev列进去了。

• 核查分支保护规则
  进入仓库Settings → Branches → Branch protection rules，找到dev分支对应的规则：

  • 确认没有设置"Restrict who can push to matching branches"并排除了能触发Actions的账号/团队；
  • 检查是否启用了"Require approval for all outside collaborators"，若你的提交属于外部协作且未获批准，会导致Actions被拦截。

• 检查仓库Actions全局权限
  进入仓库Settings → Actions → General：

  • 在"Workflow permissions"区域，确保设置为Read and write permissions（部分工作流需要写权限才能正常运行）；
  • 在"Allowed actions and reusable workflows"区域，确认没有限制仅允许官方Actions或特定工作流，否则自定义的ci.yml可能被阻止运行。

• 确认工作流文件的存在性
  直接访问仓库dev分支的工作流目录（/tree/dev/.github/workflows），确认ci.yml确实存在且提交已推送到远程仓库。有时候可能出现本地提交未推送、分支切换错误导致文件没上传的情况。

• 排查页面缓存问题
  GitHub Actions标签页偶尔会有缓存延迟，导致新分支的工作流不显示。可以尝试：

  • 强制刷新页面（Ctrl+F5/Command+Shift+R）；
  • 用无痕浏览器打开Actions页面；
  • 直接访问该工作流的分支专属记录页：/actions/workflows/ci.yml?query=branch%3Adev，查看是否有运行记录。

• 检查工作流语法错误
  虽然main分支的文件能运行，但dev分支的ci.yml可能被误改出现语法问题。打开dev分支的该文件，GitHub会实时检查语法，错误会在页面顶部以红色提示显示，修正后重新提交即可。

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