如何修复或避免GitHub Actions中output命令处理失败错误？

算力阿峰

2026-8-15

解决GitHub Actions多行输出格式错误问题

GitHub废弃echo "::set-output name=x::y"命令后，改用echo "x=y" >> $GITHUB_OUTPUT传递变量时，若变量包含多行CSV内容，会因换行符触发「Error: Unable to process file command 'output' successfully. Error: Invalid format」错误，以下是两种可靠的解决方法：

Heredoc语法写入（推荐）
利用Heredoc可以完整保留多行内容的格式，同时符合$GITHUB_OUTPUT的解析规则：
```
{
  echo 'message<<EOF'
  echo "$message"
  echo EOF
} >> $GITHUB_OUTPUT
```
注意：EOF是自定义分界符，若你的CSV内容中包含该字符串，可替换为其他唯一标识（比如CSV_END），避免解析冲突。
转义换行符后写入
通过printf将变量中的换行符转义为\n，后续步骤读取时再还原：
```
echo "message=$(printf '%q' "$message")" >> $GITHUB_OUTPUT
```
在后续步骤中，使用echo -e "$message"即可还原原始的多行CSV格式。