git am:补丁格式损坏
快速摘要
你用损坏或格式错误的 mbox 补丁文件运行了 git am —— git 无法解析提交元数据或 diff 内容。
为什么发生
补丁文件在下载或邮件传输中被截断,diff 内容部分缺失
mbox 格式的邮件头无效或多个补丁之间缺少分隔行
传输过程中行尾从 LF 转为 CRLF(或相反),破坏了 diff 上下文行
最小示例
✗ 错误代码
git am patch.mbox # error: patch format defect: truncated diff
# or: Patch is empty✓ 修复代码
dos2unix patch.mbox # fix line endings
git am --abort # clean up partial state
git am patch.mbox # retry with fixed file修复行尾并中止部分应用状态后,git 可以从干净的起点重新解析补丁,解决格式损坏。
如何诊断
用 cat 或 less 检查补丁文件是否有截断、缺失头部或内容损坏
运行 file patch.mbox 检查编码和行尾 —— 补丁必须使用 LF 行尾
使用 git am --abort 清理部分应用的状态,然后重新检查补丁来源
如何修复
从原始来源重新下载或重新导出补丁,获取完整未损坏的文件
用 dos2unix patch.mbox 或 sed -i 's/\r$//' patch.mbox 修复行尾后应用
将多补丁 mbox 拆分为单独文件,用 git am 逐个应用以隔离损坏条目
如何预防
使用 git format-patch 生成干净 mbox 格式的补丁,并以二进制方式传输避免行尾损坏
用 git am 提交前先用 git apply --check 验证补丁完整性,及早发现格式问题