必须只装微软官方chinese (simplified) language pack,安装后需手动执行configure display language并设locale为"zh-cn",保存后重启生效;其他汉化插件已停更且无效。

只装一个汉化插件:官方 Chinese (Simplified) Language Pack for Visual Studio Code
VSCode 的中文支持,必须只装微软官方发布的那一款。其他名字带“中文”“汉化”“Pro”的插件,发布者不是 Microsoft、ID 不是 ms-ceintl.vscode-language-pack-zh-hans 的,一律不装——这些在 VSCode 1.80+ 版本中已停止维护,装了也不生效。
安装后界面仍是英文?不是插件问题,是没触发语言切换:
- 按
Ctrl+Shift+P打开命令面板,输入并选择Configure Display Language - 在打开的
locale.json文件里,把"locale": "en"改成"locale": "zh-cn"(注意大小写和短横线) - 保存后必须点弹窗里的
Restart,Reload Window不会重载语言配置
改完还是英文?检查路径是否正确:%APPDATA%\Code\User\locale.json(Windows)、~/Library/Application Support/Code/User/locale.json(macOS)、~/.config/Code/User/locale.json(Linux)。如果右下角状态栏的 locale 是灰色不可点,说明被企业策略或环境变量 VSCODE_LANG=en 强制锁定了。
GitLens 和 Git Graph:中文界面下依然好用的 Git 协作双件套
这两个插件本身不依赖语言包,但中文界面能让菜单、提示、悬停文字更易读。它们解决的是真实协作中的高频痛点:
-
GitLens:光标悬停某行,立刻显示谁、何时、为什么改这行;按Alt+Click查看 Blame;Ctrl+Shift+G呼出侧边 GitLens 面板,查提交、比差异、跳 commit -
Git Graph:可视化分支拓扑图,直接在图上创建/删除/合并分支、rebase、cherry-pick,比命令行更直观,尤其适合刚接触 Git 的团队成员
注意:GitLens 默认开启行内 Blame,但如果你项目用了 monorepo 或大量子模块,建议在设置里搜索 gitlens.advanced.git.command,设为 git 而非默认的 nodegit,避免某些仓库路径解析失败。
路径补全与导入提示类插件:中文环境下仍需手动确认兼容性
Path Intellisense 和 Auto Import 这类插件,在中文路径或含中文文件名的项目里容易出问题:
-
Path Intellisense对@/别名支持良好,但若jsconfig.json或tsconfig.json中baseUrl指向含中文字符的目录(如D:\我的项目\src),路径补全可能中断或乱码——建议开发路径避开中文 -
Auto Import在.tsx文件中能准确识别类型并补全,但在纯.js项目中,若未配@types或 JSDoc 类型标注,常漏补或错补;遇到这种情况,优先检查jsconfig.json是否存在且"checkJs": true
这类插件本身无中文适配开关,但它们的行为受项目配置和文件系统编码影响更大,而不是界面语言。
别碰“深度汉化”第三方菜单插件
像 Chinese Menu 或 vscode-zh-hans-menu 这类插件,目标是把右键菜单、调试器面板等冷门区域也翻译成中文。实际体验中问题不少:
- 更新滞后:VSCode 主体功能迭代快,这些插件常延迟 2–3 个版本才跟进,导致部分新菜单项仍为英文,甚至出现翻译覆盖原始文案的 bug
- 冲突风险:和官方语言包共存时,偶尔会覆盖
locale.json设置,导致重启后语言回退 - 覆盖率虚高:所谓“100% 汉化”,其实只覆盖了约 60% 的非核心 UI 区域,剩下 40%(比如终端输出、调试控制台、扩展日志)根本无法翻译,反而制造“已全汉化”的错觉
真正值得花时间调的,是让代码本身更清晰——比如用 ESLint + Prettier 统一风格,比纠结某个按钮是不是中文,对长期协作的影响大得多。











