深入解析 tj-actions/changed-files 中 since_last_remote_commit 的使用问题

在 GitHub Actions 的工作流自动化中，tj-actions/changed-files 是一个非常实用的 Action，它可以帮助开发者识别代码库中发生变更的文件。然而，在使用 since_last_remote_commit 参数时，特别是在处理新创建的 Pull Request 时，开发者可能会遇到一些预期之外的行为。

问题现象

当开发者在工作流中配置了 since_last_remote_commit: true 参数，并在新创建的 Pull Request 中触发该工作流时，可能会遇到如下错误：

Unable to locate the previous commit in the local history. Please ensure to checkout pull request HEAD commit instead of the merge commit.

这个错误通常发生在 Pull Request 的第一次提交时，因为此时还没有"上一次远程提交"可供比较。

技术背景

since_last_remote_commit 参数的设计初衷是比较当前提交与上一次远程提交之间的差异。在正常的开发流程中，当开发者向已有分支推送多个提交时，这个参数可以很好地工作。然而，对于新创建的 Pull Request 的第一个提交，Git 历史中不存在"上一次远程提交"，这就导致了上述错误。

解决方案

针对这个问题，社区已经提供了几种解决方案：

1. 调整 checkout 的 fetch-depth 参数：将 actions/checkout 的 fetch-depth 设置为 0，这样可以获取完整的 Git 历史记录，有助于 Action 找到正确的比较基准。

2. 使用条件判断：在工作流中添加条件判断，对于新创建的 Pull Request 使用不同的比较策略。

3. 更新 tj-actions/changed-files 版本：最新版本的 Action 已经对这个问题进行了优化处理。

最佳实践建议

在实际项目中使用 tj-actions/changed-files 时，建议开发者：

• 始终使用最新版本的 Action，以确保获得最新的错误修复和功能改进
• 对于新项目或新分支的工作流，考虑设置合理的 fetch-depth 值
• 在关键工作流中添加错误处理逻辑，确保工作流不会因为文件比较失败而完全中断
• 对于只需要检测特定文件变更的场景，可以结合 files 参数一起使用，提高效率

技术实现原理

深入理解这个问题的技术原理有助于开发者更好地使用这个 Action。当设置 since_last_remote_commit: true 时，Action 内部会尝试执行以下操作：

1. 获取当前提交的 SHA
2. 查找 Git 历史中的上一次远程提交
3. 比较这两个提交之间的文件差异

在新 Pull Request 的场景下，由于缺少历史提交记录，第二步会失败，导致整个比较过程无法完成。最新版本的 Action 已经对此进行了优化，能够在找不到历史提交时采用更合理的默认行为。

通过理解这些技术细节，开发者可以更灵活地配置和使用 tj-actions/changed-files，使其在各种场景下都能稳定工作。