VS Code中文界面生效的唯一正确路径是安装Microsoft官方语言包ms-ceintl.vscode-language-pack-zh-hans,执行Configure Display Language命令并严格选择zh-cn,重启后生成精准的locale.json文件;其他插件、配置或变体均无效。

装错插件是中文不生效的最常见原因
VS Code 界面语言不会因为装了任意带“中文”字样的插件就变中文。真正起作用的只有一个:ms-ceintl.vscode-language-pack-zh-hans,对应市场里显示为 Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft。
常见错误现象包括:命令面板搜不到 Configure Display Language、设置页仍英文、右下角状态栏语言代码始终是 en。
- 在扩展面板(
Ctrl+Shift+X)中,必须完整输入Chinese (Simplified) Language Pack for Visual Studio Code,不能只输chinese或zh-hans - 认准图标含蓝白 VS 标志、作者栏写的是 Microsoft,其他如
Chinese Menu、VSCode Chinese等第三方插件一律跳过 - 安装后右下角会弹出
Change Language and Restart提示——必须点它;仅点Reload Window不生效
Configure Display Language 命令只认严格小写的 zh-cn
这个命令不是“选中文”,而是往 locale.json 里写一个 BCP 47 标准的标识符。任何变体都会静默失败,界面维持英文且无报错提示。
常见错误包括:误选 zh_CN、zh-hans、Chinese,或输错命令名(比如搜 change language 或 chinese)。
- 按
Ctrl+Shift+P打开命令面板,输入并执行Configure Display Language(注意大小写和空格) - 从下拉列表中**手动滚动找到并点击**
zh-cn—— 它是唯一合法值,首字母大写、下划线、短横线错位都不行 - 弹窗提示 “是否重启窗口” 时,必须点 是;点 “否” 或关闭弹窗,配置根本不会写入
locale.json 路径和内容必须精准,重启要彻底
该文件不在 settings.json 里,也不在安装目录,而是在用户数据目录下。改错位置、编码含 BOM、多加逗号或空格,都会导致配置被忽略。
命令面板失效、切换后仍英文,90% 是因为没关干净进程,或文件路径/内容不对。
- Windows 路径:
%APPDATA%\Code\User\locale.json
macOS 路径:~/Library/Application Support/Code/User/locale.json
Linux 路径:~/.config/Code/User/locale.json - 文件内容只能是严格合法的 JSON:
{"locale":"zh-cn"}(无 BOM、无多余空格、无逗号、无注释) - 保存后必须关闭所有 VS Code 窗口,并确认后台进程已退出:
Windows 查任务管理器中是否还有Code.exe
macOS 用活动监视器查Electron进程
终端、调试控制台、Git 输出默认不随 locale 变
很多人反复折腾后发现「菜单栏中文了,但终端还是英文」「调试面板乱码」,于是怀疑汉化失败。其实这是正常行为——这些区域的语言由各自运行时环境决定,和 VS Code 的 locale 无关。
验证是否真汉化成功,只盯三处:
- 顶部菜单栏文字(File、Edit、View…)
- 左侧活动栏 hover 提示(如
Explorer显示为资源管理器) - 设置页搜索
locale,确认值为zh-cn
这三处对了,就是配置完成。其他区域的英文不是 bug,是设计如此。


















