在 GitHub Actions 中，需同时获取 Python 脚本的多行标准输出（stdout）并准确传递其退出码（exit code）以触发步骤失败，但默认重定向或 heredoc 写入 $GITHUB_OUTPUT 会吞没退出码。本文提供安全、可靠、可维护的解决方案。
在 github actions 中，需同时获取 python 脚本的多行标准输出（stdout）并准确传递其退出码（exit code）以触发步骤失败，但默认重定向或 heredoc 写入 `$github_output` 会吞没退出码。本文提供安全、可靠、可维护的解决方案。
在 CI/CD 流程中（如 PR 检查），我们常依赖脚本的退出码判断成败（0 成功，非 0 失败），同时需要将结构化或多行日志输出用于后续自动评论或摘要展示。然而，直接使用 echo "output<<EOF" 方式捕获输出会隐式忽略子进程退出状态——因为 bash 的管道和重定向本身成功执行，导致整个 step 始终返回 0，无法触发失败逻辑。
✅ 正确方案：用文件中转 + 显式错误检查
核心思想是：不依赖 $GITHUB_OUTPUT 捕获多行内容，而是将脚本输出暂存为文件，并在同一步骤中显式检查退出码。这样既保留了原始 exit code 的语义，又避免了 heredoc 解析风险（如输出含 EOF 字符串导致截断）。
以下是推荐工作流片段（已适配你的场景）：
- name: Run script and preserve exit code
id: check_data
shell: bash
run: |
# 执行脚本，同时捕获 stdout 到文件，并保留 exit code
if ! python tools/check_data.py "$BRANCH" > comment.txt 2>&1; then
echo "Script failed with exit code $?" >&2
exit $? # 显式退出，确保 step 失败
fi? 说明：if ! ...; then exit $? 是关键。它确保：
- 成功时，comment.txt 包含完整输出（含 stderr）；
- 失败时，$? 获取原始 Python 脚本退出码，并立即传递给 step，触发后续 failure() 条件分支。
? 后续使用输出文件（支持多行 & 自动评论）
GitHub Actions 原生支持通过 path 参数读取文件内容用于评论或摘要，比解析 $GITHUB_OUTPUT 更健壮：
- name: Auto comment on PR
if: github.event.pull_request && (success() || failure())
uses: marocchino/sticky-pull-request-comment@v2.9.0
with:
recreate: true
header: data-check-result
path: comment.txt该 Action 会：
- 自动将 comment.txt 全文（含换行、空格、特殊字符）作为 PR 评论；
- 若已存在同 header 的评论，则原地更新，避免刷屏；
- 支持 success() 和 failure() 双态触发，确保无论检查通过与否都反馈结果。
⚠️ 注意事项与最佳实践
- 禁止在 run 中混用 set -e 或隐式管道捕获：例如 python ... | tee file.txt 会丢失上游退出码（因 tee 成功即返回 0）。必须用 if ! cmd; then exit $?; fi 显式控制。
- 始终重定向 stderr：使用 > file.txt 2>&1 确保错误信息不丢失（如 ImportError、FileNotFoundError），这对调试至关重要。
- 环境变量安全：推荐使用 env: 块声明 BRANCH，而非 echo "BRANCH=..." >> $GITHUB_ENV，避免命令注入风险（GitHub 官方安全指南）。
- 超时与资源保护：为 check-data job 添加 timeout-minutes: 10，防止脚本卡死阻塞 CI。
- 本地验证技巧：在本地用 bash -x 模拟执行该 run 块，确认 exit code 传播行为符合预期。
✅ 总结
要真正实现「输出可捕获 + 退出码不失真」，唯一可靠路径是：
放弃 $GITHUB_OUTPUT 处理多行内容 → 改用临时文件存储 → 在同一 run 步骤内显式检查并透传退出码 → 由下游 action（如 sticky-comment）按需读取文件。
该模式简洁、安全、可测试，且完全兼容 GitHub Actions 的失败传播机制，是生产环境 PR 自动检查的推荐范式。
