解决 create-pull-request 中 Unicode 文件名导致的 Blob 创建问题

在 GitHub Actions 中使用 create-pull-request 自动化创建 PR 时，开发者可能会遇到一个特殊问题：当仓库中包含 Unicode 字符的长文件名时，某些文件的 blob 对象无法正常创建。本文将深入分析这个问题的成因和解决方案。

问题现象

当工作流运行时，对于包含 Unicode 字符（如箭头符号 →）的长文件名，create-pull-request 操作会报错：

Error creating blob for file '"tests/.pest/snapshots/E2E/Console/CommandTest/_TypistTech_PhpMatrix_Console_Command__\342\206\222_it_success_with_data_set_____7_3_1____________auto_______full_______7_3_1_________auto____full__.snap"': ENOENT: no such file or directory

有趣的是，同一工作流中的其他文件（如纯 ASCII 字符命名的文件）却能正常处理。这表明问题与文件名中的特殊字符有关。

根本原因

经过分析，这个问题主要出现在以下场景：

1. 当启用 sign-commits 选项时
2. 文件名中包含 Unicode 字符
3. 文件路径较长且复杂

核心问题在于签名提交时，文件路径中的 Unicode 字符未能正确保留，导致系统无法找到对应的文件。

解决方案

项目维护者已经发布了修复版本 v7.0.6/v7，该版本专门解决了 Unicode 字符在文件路径中的处理问题。对于遇到此问题的用户，建议：

1. 将 create-pull-request 操作升级到 v7.0.6 或更高版本
2. 如果仍使用旧版本，可以考虑暂时禁用 sign-commits 选项作为临时解决方案

最佳实践

为避免类似问题，建议开发者在自动化工作流中：

1. 尽量使用 ASCII 字符命名测试文件和快照文件
2. 保持文件名简洁，避免过长的路径和名称
3. 定期更新 GitHub Actions 到最新稳定版本
4. 对于必须使用 Unicode 字符的场景，确保使用最新版工具链

总结

文件名编码问题在跨平台开发中很常见。create-pull-request 的这次修复展示了开源社区对这类边缘案例的快速响应能力。作为开发者，理解这些问题的成因有助于我们设计更健壮的自动化工作流，避免类似问题的发生。