Skip to content

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 验证补丁完整性,及早发现格式问题

相关资源

相关术语

相关课程

← 返回语言