为什么git diff、git show会将制表符替换为空格，如何解决该问题？

问题原因 #

这个现象本质是展示层的视觉效果，不会真正修改补丁的原始内容：

• 当git diff、git show的输出直接指向交互式终端（TTY）时，Git会默认调用分页器（通常为less）对输出做展示优化，部分系统的默认分页器参数会将制表符渲染为固定数量的空格，仅用于终端显示，不会改动原始字符。只有当你手动从终端界面复制diff内容时，才会得到替换后的空格，导致补丁损坏。
• 当输出指向管道、文件等非交互式目标时，Git会跳过分页器和展示优化逻辑，直接输出原始内容，所以git format-patch生成的文件、git diff > patch重定向生成的补丁文件，都会保留原始制表符，不存在字符损坏问题。

解决方案 #

临时单次获取原始内容 #

• 跳过Git分页器直接输出：

  git --no-pager diff
  git --no-pager show <commit哈希>
  

• 将输出管道传递给cat绕过展示处理：

  git diff | cat
  

• 直接将diff重定向到文件，得到的补丁文件天然保留原始制表符：

  git diff > 补丁文件.patch
  

永久修改终端展示行为，不再把制表符显示为空格 #

如果你希望终端直接查看diff时也保留制表符的展示逻辑，可以修改Git全局分页器配置：

git config --global core.pager "less -F -X -R"

参数说明：

• -F：内容少于一屏时自动退出分页器
• -X：退出分页器时保留屏幕内容
• -R：支持颜色输出
  该配置不会修改制表符的原始内容，只会按照终端默认的制表位宽度展示制表符。如果需要自定义制表符的展示宽度（比如显示为4个字符宽度），可以修改为：

git config --global core.pager "less -F -X -R -x4"

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