必须安装Microsoft官方中文语言包、执行Configure Display Language设zh-cn并彻底重启;仅装插件或仅改设置无效,第三方汉化插件易致乱码或崩溃。

VSCode 默认支持中文界面,但需要手动启用语言包并重启,不是改个设置就立刻生效。
安装 Chinese (Simplified) Language Pack
VSCode 本身不内置中文界面,必须通过扩展安装官方语言包:
- 打开 Extensions 面板(
Ctrl+Shift+X或左侧图标) - 搜索
Chinese (Simplified) Language Pack for Visual Studio Code(发布者是Microsoft) - 点击 Install,安装完成后会提示“已安装,需重启 VSCode”
⚠️ 注意:不要装第三方汉化插件(如某些“汉化补丁”或非 Microsoft 签名的包),它们可能破坏更新机制或注入异常逻辑。
设置 "locale" 配置项为 "zh-cn"
安装完语言包后,还需显式指定界面语言,否则仍显示英文:
- 按
Ctrl+Shift+P打开命令面板,输入并选择Configure Display Language - 在弹出的 JSON 文件中,将
"locale"的值设为"zh-cn"(注意是双引号包裹的字符串) - 保存文件,然后完全退出 VSCode(包括系统托盘进程),再重新启动
✅ 正确写法:"locale": "zh-cn";❌ 错误写法:"locale": zh-cn(缺引号)、"locale": "zh"(不被识别)。
重启后仍显示英文?检查这几点
常见失效原因不是配置错,而是环境或缓存干扰:
- 确认没有在命令行中用
--locale=en启动 VSCode(比如终端别名或桌面快捷方式里硬编码了) - 检查用户设置 JSON 中是否有多余的
"locale"条目(例如在settings.json里误加了同名字段,它会覆盖语言包配置) - Windows 用户若用「开始菜单」快捷方式启动,右键 → 属性 → “目标”字段末尾是否带了
--locale=en?删掉 - macOS / Linux 用户可尝试终端执行
code --locale=zh-cn测试是否临时生效,确认是配置问题还是启动参数覆盖
真正卡住的地方往往不是“怎么设”,而是“谁在偷偷覆盖”。语言切换依赖完整重启 + 无外部 locale 参数干扰,这两个条件缺一不可。


















