GitHub Actions中自定义pytest Workflow推送后不显示的问题求助

可能的原因及排查步骤 #

• 检查文件路径与命名
  确认文件确实存放在仓库根目录的.github/workflows/文件夹下，文件名后缀必须是.yml或.yaml，注意GitHub对路径大小写敏感，比如.Github或Workflows这类错误大小写会导致识别失败。同时确保文件已经提交并推送到远程特性分支，本地修改后执行git add .github/workflows/pytest.yml && git commit -m "add pytest workflow" && git push确认推送成功。

• 验证YAML语法正确性
  YAML对缩进要求严格，哪怕一个空格错误都会导致Workflow无法识别。可以用本地工具（如yamllint）校验你的配置文件：

  name: Run pytest on push
  
  on:
    push:
      branches:
        - '*'
  
  jobs:
    pytest:
      runs-on: ubuntu-latest
  
      steps:
      - name: Checkout code
        uses: actions/checkout@v2
  
      - name: Set up Python
        uses: actions/setup-python@v2
        with:
          python-version: 3.9
  
      - name: Install dependencies
        run: pip install -r requirements.txt
  
      - name: Run pytest
        run: pytest backend/tests
  

  检查每个步骤的缩进是否一致，with字段是否嵌套在对应的uses步骤下，没有多余或缺失的空格。

• 检查仓库Actions权限设置
  进入仓库的「Settings」→「Actions」→「General」页面，确认：

  • 「Allow all actions and reusable workflows」选项已勾选
  • 没有设置分支保护规则阻止Workflow在特性分支运行

• 等待GitHub同步或刷新页面
  偶尔GitHub Actions会有同步延迟，推送后等待2-3分钟，刷新仓库的「Actions」页面，或者尝试用无痕模式打开页面查看。

• 确认触发条件匹配
  虽然配置了branches: ['*']，但如果推送的是标签而非分支，不会触发该Workflow。确认你推送的是特性分支的代码改动，而非标签。

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