如何在GitHub Actions中对流水线代码及自定义动作做单元测试？

针对不同技术栈的自定义GitHub Action，可通过以下方案实现单元测试，对齐Jenkins流水线的测试能力：

1. Python 自定义动作 #

直接用pytest作为测试框架，和普通Python项目测试逻辑一致：

• 把动作核心代码放在单独目录（比如action/），测试用例放在tests/目录
• 在GitHub Workflow中新增测试Job，拉取代码、配置Python环境、安装依赖后执行测试

示例Workflow片段：

jobs:
  test-python-action:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      - run: pip install -r action/requirements.txt pytest
      - run: pytest tests/ -v

2. YAML 复合动作（Composite Actions） #

这类动作的测试分两层：

• 静态检查：用actionlint工具验证YAML语法、参数引用、步骤合法性，提前发现语法错误
• 集成测试：在测试Workflow中直接调用该复合动作，传入不同参数，检查输出变量、文件生成结果或执行状态是否符合预期

示例Workflow片段：

jobs:
  test-composite-action:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      # 静态检查
      - run: npm install -g actionlint
      - run: actionlint .github/actions/my-composite-action.yml
      # 集成测试：调用动作并验证结果
      - id: test-action
        uses: ./.github/actions/my-composite-action
        with:
          input-param: test-value
      - run: |
          if [ "${{ steps.test-action.outputs.result }}" != "expected-result" ]; then
            echo "Action output mismatch"
            exit 1
          fi

3. Node.js 自定义动作 #

用Node.js原生测试框架（jest/mocha）即可，部分社区动作自带测试逻辑，自定义动作可参考：

• 用@actions/core的mock工具模拟输入、环境变量，编写单元测试
• 在Workflow中配置Node环境，安装依赖后执行测试命令

示例Workflow片段：

jobs:
  test-node-action:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm install
      - run: npm test

4. Bash 自定义动作 #

用bats（Bash Automated Testing System）做单元测试，配合shellcheck做静态检查：

• bats用于编写脚本的功能测试，覆盖参数处理、返回值、错误场景
• shellcheck提前发现脚本的语法缺陷、逻辑隐患

示例Workflow片段：

jobs:
  test-bash-action:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      # 静态检查
      - run: sudo apt-get install -y shellcheck
      - run: shellcheck .github/actions/my-bash-action/script.sh
      # 单元测试
      - run: sudo apt-get install -y bats
      - run: bats tests/test_script.bats

关于“Jenkins比GitHub更擅长测试”的观点 #

这一说法已经过时。GitHub Actions当前的生态支持完整的测试闭环：从单元测试、静态检查到集成测试，都能通过Workflow自身实现，且直接复用各技术栈的原生测试工具，无需学习特定的Pipeline测试框架。Jenkins早期的Pipeline测试工具（如Pipeline Unit）推出较早，但GitHub Actions的方案更贴合现代DevOps工具链，只要测试用例设计合理，完全可以达到甚至超过Jenkins的测试覆盖能力。

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