Git中文乱码主因是终端与core.fileencoding编码不匹配,需统一设为UTF-8;IDE中需同步编辑器编码设置;patch报错因含二进制块,应加--no-binary;Windows下用--color=never配合iconv避免颜色丢失。

git diff 输出中文乱码或报“encoding not supported”
这不是 Git 本身不支持中文,而是它在输出时用了当前终端或配置不匹配的编码方式。常见现象是中文变成 ???、\344\270\255\346\226\207 或直接报错 fatal: invalid encoding 'GBK'。
关键点在于:Git 的 diff 命令默认依赖系统 LANG 和 core.fileencoding 配置,但这两者不一致时就会出问题——尤其 Windows 上 Git Bash 默认用 UTF-8,而文件实际是 GBK;或者 macOS 终端设了 zh_CN.UTF-8,但 Git 被强制配成 GB2312。
- 检查当前 Git 编码设置:
git config --get core.fileencoding(为空则走系统默认) - 确认终端真实编码:
locale(Linux/macOS)或chcp(Windows CMD) - 临时强制 UTF-8 输出:
git -c core.fileencoding=utf-8 diff - 永久生效(推荐):
git config --global core.fileencoding utf-8
IDEA / VS Code 中 Git Diff 显示空白或解析失败
编辑器不是直接渲染 git diff 文本,而是调用内置解析器把 diff 字符串转成结构化对象。一旦输入流里有非法字节(比如 GBK 文件混入 UTF-8 终端输出)、缺失 @@ 头、或行尾带 \r\x00 这类控制字符,解析器就静默失败,Diff 面板变空。
- 验证 diff 是否可被正确读取:
git diff --no-color --encoding=UTF-8 | head -20,看前几行是否含完整@@ -x,y +z,w @@ - IDEA 中必须统一三处编码:
File → Settings → Editor → File Encodings里设为UTF-8,勾选Transparent native-to-ascii conversion,并确保Default encoding for properties files也是 UTF-8 - VS Code 用户需检查
"files.encoding"设置是否为"utf8",且禁用可能干扰的插件(如某些旧版 Chinese Language Pack)
patch 命令报 “git binary diffs are not supported”
这个错误和编码无关,是格式冲突:你用 git diff 生成的补丁里含有二进制变更块(比如图片、jar 包),而 POSIX 标准的 patch 工具根本不认识 GIT binary patch 这种头。
- 生成可被
patch消费的纯文本补丁:git diff --no-binary --no-renames HEAD~1 > fix.patch - 检查补丁是否干净:
grep "GIT binary" fix.patch,如果返回内容,说明还有二进制变更没排除 - CI/CD 流水线中建议加校验步骤:
! grep -q "GIT binary" "$PATCH_FILE",防止带二进制的 patch 被误用
Windows 下 git diff 显示乱码且 iconv 转换后颜色丢失
Windows Git Bash 默认输出 ANSI 颜色码,但 iconv 是纯文本过滤器,会吃掉这些控制字符,导致 git diff | iconv -f GBK -t UTF-8 后没了高亮。
- 保留颜色的关键是先关闭 Git 自动着色再转码:
git --no-pager diff --color=never | iconv -c -f GBK -t UTF-8 - 更稳妥的做法是定义别名:
git config --global alias.zw '!f() { git --no-pager diff --color=never "$@" | iconv -c -f GBK -t UTF-8; }; f' - 注意:
-c参数让iconv忽略无法转换的字节,避免整个命令因个别乱码字节中断
最常被忽略的是:Git 的 core.autocrlf 设置会间接影响 diff 编码行为。如果它被设为 true(Windows 默认),Git 在读取文件时会做 CRLF/LF 转换,而该过程若与文件真实编码不匹配,会导致 diff 输出的字节流已经损坏——此时再怎么调 fileencoding 都没用。先运行 git config --get core.autocrlf,值为 true 时,建议改回 input(Linux/macOS 风格)或显式关闭(false)再试。











