如何覆盖Git对比.pdf文件的默认diff行为以规避PDF解析报错？

你遇到的报错来自Git for Windows 内置的PDF文件对比工具。很多人会以为执行git diff --text就能强制把文件当纯文本处理，但实际上Git的自定义格式解析驱动优先级高于--text参数——只要文件后缀匹配默认关联的PDF识别规则，就会优先调用内置的PDF解析程序处理文件，这和你把.pdf作为普通文本存储的实际场景不匹配，因此触发了一系列PDF格式校验报错。

调整文件属性匹配规则 #

在仓库根目录下创建/编辑.gitattributes文件，根据你实际的对比需求选择对应规则：

• 需求1：你需要Git逐行对比这类.pdf文件里的纯文本内容，且完全跳过PDF解析流程
  在.gitattributes中写入规则：

  *.pdf diff
  

  接着执行全局Git配置命令，把原本绑定给.pdf的PDF解析处理逻辑替换成直接读取原始文本：

  git config --global diff.pdf.textconv cat
  

  配置完成后，Git对比这类文件时会直接读取原始文本内容，不会调用任何PDF解析器。
• 需求2：你不需要逐行对比这类文件的具体改动，只需要让Git正常跟踪版本变更，不触发任何解析逻辑
  在.gitattributes中写入规则：

  *.pdf binary
  

  配置完成后，Git会将这类文件识别为普通二进制文件，对比时仅提示“二进制文件存在版本差异”，完全跳过PDF格式校验、解析流程。

配置验证 #

执行下面的命令可以检查当前系统给.pdf后缀关联的diff处理逻辑：

git config --get diff.pdf.command

如果输出内容包含pdftotext等PDF解析相关的命令，就说明就是该内置绑定触发了你看到的语法报错，按照上面的方案调整规则即可完全规避。

内容的提问来源于stack exchange，提问作者TheDudeWithHat