VSCode设置中文界面最可靠方式是安装微软官方中文语言包、执行Configure Display Language命令选zh-cn、重启窗口;直接改settings.json无效,因1.70+已弃用该配置,须由命令自动生成locale.json。

VSCode 本身不提供 Git 的完整中文界面,所谓“中文版 Git”实际是三部分协同的结果:VSCode 界面汉化、终端(Git Bash)语言环境、Git 提交信息的编码与显示。直接改 git config --global i18n.LANG zh-Hans 不仅无效,还可能让 git status 输出乱码或命令报错。
VSCode 界面必须先汉化,否则 Git 面板全是英文
这是最基础也最容易被跳过的一步。没有中文语言包,后续所有 Git 操作面板(如源代码管理视图、提交按钮、分支下拉菜单)都保持英文。
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language,选zh-CN→ 重启 VSCode - 别装第三方“汉化插件”,只认准微软官方的
Chinese (Simplified) Language Pack for Visual Studio Code(带蓝勾) - 重启后若仍为英文,检查
settings.json是否含"locale": "zh-CN",且无拼写错误(比如写成zh-cn小写在旧版本中可能失效)
Git Bash 终端显示中文需设 UTF-8 编码,不是改 LANG
git config --global i18n.LANG zh-Hans 在绝大多数 Git 版本中已被弃用,且 Windows 上 Git Bash 默认不读取该配置。真正起作用的是终端自身的 locale 和 Git 的 commit encoding 设置。
- 确保 Git Bash 启动时使用 UTF-8:右键 Git Bash 图标 → Properties → Options → Active code page → 改为
65001 - 在 Git Bash 中运行:
git config --global core.quotepath false(避免中文路径被转义成"xxx\344\270\200\345\205\203") - 设置提交信息编码:
git config --global i18n.commitencoding utf-8,否则用中文写git commit -m "修复登录"后,git log可能显示问号
VSCode 内置终端(Terminal)要切换成 Git Bash 并加载中文环境
VSCode 默认终端是 Windows PowerShell 或 cmd,它们对中文支持差,且不自动加载 Git 的环境变量。不切终端,你在 VSCode 里敲 git status 可能看不到中文文件名,甚至报 'git' is not recognized。
- 打开 VSCode 设置(
Ctrl+,),搜terminal.integrated.defaultProfile.windows,设为Git Bash - 如果没这个选项,手动编辑
settings.json,加一行:"terminal.integrated.defaultProfile.windows": "Git Bash" - 验证是否生效:按
Ctrl+Shift+`新开终端,第一行应显示类似user@DESKTOP-XXX MINGW64 ~/project,且输入git --version有响应
提交流程中的中文陷阱:status、diff、commit 全链路验证
很多人以为“能输中文 commit message 就算汉化成功”,其实中间环节断裂很常见——比如 git status 显示乱码,但 git commit -m 能提交;或者 diff 中文内容无法高亮。
- 测试
git status:新建一个含中文名的文件(如用户管理.md),执行git status,文件名应清晰显示,而非"\347\224\250\346\210\267..." - 测试
git diff:修改中文文件内容后运行git diff,变动行应正常显示中文,且语法高亮可用 - 测试
git log --oneline:提交后运行,中文 commit message 必须可读;若出现方块或问号,回退检查i18n.commitencoding和终端 code page
真正卡住人的从来不是某一步操作,而是多个环节的编码假设不一致:VSCode 认为你用 UTF-8,Git Bash 实际跑在 GBK,而 Git 自己又按 ISO-8859-1 解 commit 日志——这种隐性错位不会报错,只会默默显示乱码。动手前先确认终端当前编码(locale 命令)、Git 配置输出(git config --list | grep i18n)、以及 VSCode 设置里的 locale 三者是否统一指向 UTF-8 和 zh-CN。


















