解决 tj-actions/changed-files 中特殊字符导致的 JSON 解析问题

在 GitHub Actions 工作流中使用 tj-actions/changed-files 动作时，当文件路径中包含特殊字符（如括号）可能会导致 JSON 解析错误。这个问题常见于使用 Next.js 框架的项目，因为 Next.js 的路由组约定会创建包含括号的文件夹名称。

问题现象

当工作流尝试将包含括号的路径转换为 JSON 格式时，会出现"Bad JSON escape sequence"错误。例如，路径".github/workflows/(folder)/testfile.txt"会被转义为".github/workflows/(folder)/testfile.txt"，导致后续的 fromJSON 函数解析失败。

根本原因

tj-actions/changed-files 默认启用了 safe_output 选项，该选项会自动对可能不安全的 shell 字符进行转义处理。这是为了防止特殊字符在 shell 环境中引发意外行为的安全措施。

解决方案

对于需要保留原始路径中特殊字符的场景，可以通过以下两种方式解决：

1. 禁用安全输出：在 changed-files 动作中设置 safe_output: false

- uses: tj-actions/changed-files@v45
  with:
    safe_output: false

2. 手动处理转义字符：如果出于安全考虑不能完全禁用安全输出，可以在后续步骤中对转义字符进行反向处理

最佳实践建议

1. 在确保安全的前提下使用 safe_output: false
2. 对于关键工作流，建议添加路径验证步骤
3. 考虑在 CI/CD 流程中避免使用可能引起问题的特殊字符
4. 对于 Next.js 项目，可以评估是否必须使用括号命名路由组

总结

正确处理文件路径中的特殊字符是自动化工作流中的重要环节。通过理解 tj-actions/changed-files 的安全机制和适当配置，可以确保工作流在各种文件命名约定下都能稳定运行。