解决Git中文乱码问题方法详解

本文详细介绍了在Windows系统中彻底解决Git中文乱码问题的五大关键步骤：从关闭路径转义、统一配置UTF-8编码，到调整终端输入输出行为、修复less分页器显示异常，再到增强ls命令对中文文件名的支持，每一步都配有具体操作命令和验证方法，帮助开发者一劳永逸地告别“\346\265\213\350\257\225.txt”这类八进制乱码，让中文文件名、提交日志和命令行输出真正清晰可读、原样呈现。

一、关闭 Git 路径引用处理

Git 默认启用 core.quotepath 选项，会将中文路径转义为八进制编码（如 \346\265\213\350\257\225.txt），导致文件名不可读。将其设为 false 可强制 Git 直接输出原始 UTF-8 文件名，前提是终端支持 UTF-8。

1、打开 Git Bash 或 Windows 命令提示符。

2、执行命令：git config --global core.quotepath false。

3、验证是否生效：在含中文文件的仓库中运行 git status，观察文件名是否显示为“测试.txt”而非转义串。

二、配置 Git 全局编码参数

Git 日志、提交信息等输出依赖 i18n 编码设置。若未显式指定，Windows 下可能沿用 GBK/GB2312，与 UTF-8 仓库内容不匹配，引发日志和标签中的中文乱码。

1、设置提交时使用的编码：git config --global i18n.commitEncoding utf-8。

2、设置日志输出时的编码：git config --global i18n.logOutputEncoding utf-8。

3、设置 GUI 工具默认编码（如 Git GUI）：git config --global gui.encoding utf-8。

三、修改 Git Bash 终端底层输入输出行为

Git Bash 默认禁用 UTF-8 元字符输出，并对输入元字符进行转换，导致中文无法输入或显示为问号。需调整 /etc/inputrc 中的 meta 处理策略。

1、使用文本编辑器以管理员权限打开文件：C:\Program Files\Git\etc\inputrc。

2、定位到以下两行：

set output-meta off

set convert-meta on

3、将其修改为：

set output-meta on

set convert-meta off

四、修复分页器 less 的中文显示问题

执行 git log 时，Git 默认调用 less 分页，而 less 默认不识别 UTF-8 编码，造成日志中中文显示为方块或乱码。需通过环境变量告知 less 使用 UTF-8 解析字符。

1、以管理员权限编辑文件：C:\Program Files\Git\etc\profile。

2、在文件末尾新增一行：export LESSCHARSET=utf-8。

3、保存后重启 Git Bash，再运行 git log 验证中文是否正常显示。

五、增强 ls 命令对中文文件名的支持

即使 Git 配置正确，Git Bash 内置的 ls 命令仍可能因未启用控制字符显示，导致中文文件名呈现为问号。该问题独立于 Git 配置，需通过别名重定义 ls 行为。

1、以管理员权限编辑文件：C:\Program Files\Git\etc\git-completion.bash。

2、在文件末尾添加一行：alias ls='ls --show-control-chars --color=auto'。

3、保存并重启 Git Bash，在含中文文件的目录下执行 ls，确认文件名清晰可读。

今天关于《解决Git中文乱码问题方法详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！