必须安装Microsoft官方简体中文语言包并彻底重启VS Code才能生效,第三方插件无效;配置语言需严格输入小写zh-cn并重启,后台进程残留会导致locale.json不重读。

装完中文语言包后界面仍是英文,不是插件没起作用,而是 VS Code 还没加载它——必须显式激活并彻底重启,否则永远显示英文。
必须安装 Microsoft 官方 Chinese (Simplified) Language Pack for Visual Studio Code
搜“中文”“汉化”大概率装到第三方插件,比如 Chinese UI 或 VSCode Chinese,它们不翻译命令面板、设置项、错误提示,还可能引发乱码或崩溃。真正有效的只有一个:
- 在扩展面板(
Ctrl+Shift+X)中完整输入:Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是 Microsoft,ID 是
ms-ceintl.vscode-language-pack-zh-hans - 安装后右下角会弹出
Restart to enable提示——点它,别只点Reload Window
Configure Display Language 命令只认严格小写的 zh-cn
语言包只是“字典”,真正决定界面语言的是 locale 配置值。这个值必须完全符合 BCP 47 标准:
- 有效值仅限:
zh-cn(全小写、短横线、无空格) - 无效写法:
zh_CN、ZH-CN、zh-hans、Chinese (Simplified)——全部静默失败,不报错也不生效 - 操作路径:
Ctrl+Shift+P→ 输入Configure Display Language→ 在下拉列表中**滚动找到并点击zh-cn**(不是靠关键词匹配,也不是点“简体中文”文字项) - 弹窗提示“需要重启窗口以应用更改”,必须点
Restart,点Cancel或关掉弹窗等于没做
重启必须杀干净后台进程,否则 locale.json 不重读
locale.json 只在全新启动时读取。如果后台残留进程,新窗口会继承旧环境,始终显示英文:
- Windows:任务管理器中确认无
Code.exe或Code Helper进程 - macOS:活动监视器中搜索
Electron,全部退出;或终端执行pkill -f "Code Helper" - Linux:运行
pkill -f "code"再启动 - 验证是否真生效:看顶部菜单栏(文件/编辑/视图)、命令面板提示(请输入命令或搜索设置)、设置左侧导航(用户/工作区/扩展)——这三处变中文才算成功
命令面板失效时直接编辑 locale.json 文件
当 Configure Display Language 找不到、点不动、或选了 zh-cn 仍无效,说明配置根本没写入。此时手动写死最可靠:
- 彻底退出 VS Code(包括所有后台进程)
- 定位并编辑
locale.json文件:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件内容必须严格为:
{"locale":"zh-cn"}(无 BOM、无多余空格、无逗号、JSON 合法) - 保存后重新启动 VS Code
真正卡住人的地方往往不是找不到插件,而是右下角弹出的“Change Language and Restart”被误点成“仅当前窗口”,或者点了“Don’t show again”后就再没机会触发——那个提示只出现一次,关了就得手动进命令面板调 Configure Display Language。


















