登录
首页 >  文章 >  软件教程

WindowsGit中文乱码解决方法

时间:2026-03-25 09:07:48 122浏览 收藏

推广推荐
前往下载Windows工具 ➜
支持 PC / 移动端,安全直达
本文是一份针对Windows环境下Git中文乱码问题的实用避坑指南,系统梳理了五步关键配置:关闭路径转义、统一UTF-8编码设置、调整终端输入输出元字符行为、修复less分页器中文显示、增强ls命令对中文文件名的支持,每一步均提供清晰命令、修改路径和验证方法,助你彻底告别“\346\265\213\350\257\225.txt”式乱码,让中文文件名、日志、提交信息在Git Bash中原样清晰呈现。

Windows怎么解决Git中文文件名乱码_Windows如何配置Git正确显示中文文件名和路径【避坑】

一、关闭 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,确认文件名清晰可读。

以上就是《WindowsGit中文乱码解决方法》的详细内容,更多关于的资料请关注golang学习网公众号!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>