gha-step-isolation

诊断并修复 GitHub Actions 中的一个常见问题：某个步骤向 GITHUB_PATH 或 GITHUB_ENV 写入内容后，立即尝试在同一步骤中使用新增的 PATH 条目或环境变量——这种做法会失败，因为 GITHUB_PATH 和 GITHUB_ENV 的更改仅从下一个步骤开始生效。当出现以下情况时触发此问题：某个步骤将工具安装到自定义目录（例如 `~/.local/bin`），将其追加到 `$GITHUB_PATH`，随后在同一步骤中调用该工具却收到“command not found”错误；调试时遇到“本地运行正常，但在 Actions 中失败”的问题，尤其是针对新安装的 CLI 工具；某个步骤写入 `$GITHUB_ENV` 后，在同一 `run:` 块中立即读取该变量却得到空值；或在审查/编写安装并使用工具的工作流步骤时。解决方案包括：在同一步骤中内联导出 PATH（而非依赖 GITHUB_PATH），或将安装步骤与首次使用步骤拆分为两个独立步骤。此外，建议使用 runner 工具断言（如 `command -v`）快速失败，避免后续出现令人困惑的“command not found”错误。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本