如何在GitHub Actions中完整保存步骤输出至文件？

有几种实用方法可以将步骤的所有输出（包括控制台显示的内容）保存到文件中，供后续步骤使用或留存：

1. 直接重定向命令输出 #

在run指令中，将命令的标准输出和错误输出一起重定向到文件：

- name: 执行命令并保存输出
  run: your-command > step-output.log 2>&1

说明：2>&1表示将错误输出（stderr）合并到标准输出（stdout）中，确保控制台显示的所有内容都写入文件。

2. 同时输出到控制台和文件 #

如果需要在控制台正常显示输出的同时保存到文件，可以使用tee命令：

- name: 运行插件并保存输出
  id: plugin-step
  run: |
    your-plugin-command | tee plugin-output.log
    # 可选：将文件内容设为步骤输出变量，供后续步骤调用
    echo "output=$(cat plugin-output.log)" >> $GITHUB_OUTPUT

后续步骤可以通过${{ steps.plugin-step.outputs.output }}获取该输出内容。

3. 上传文件留存 #

如果需要在工作流结束后仍能查看文件，可以将保存的日志文件上传为工件：

- name: 上传输出日志
  uses: actions/upload-artifact@v4
  with:
    name: step-logs
    path: plugin-output.log

工作流结束后，你可以在GitHub的工作流页面下载该工件。

Windows Runner 注意事项 #

如果使用Windows环境的runner，重定向语法略有不同，PowerShell下可以这样写：

- name: Windows环境保存输出
  run: your-command *>&1 > step-output.log

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