VSCode中文不生效的根本原因是官方语言包未正确安装或locale.json配置错误。需卸载非官方汉化插件,仅安装ID为ms-ceintl.vscode-language-pack-zh-hans的官方包,并严格按路径编辑UTF-8编码的locale.json为{"locale":"zh-cn"},远程开发需在远程端单独配置。

Configure Display Language 命令搜不到
这说明 VSCode 根本没识别到中文语言包,不是设置问题,而是安装环节就失败了。常见原因有:装了第三方“汉化插件”(比如名字带“中文支持”“VSCode Chinese”的非官方扩展),或者网络异常导致官方包 ms-ceintl.vscode-language-pack-zh-hans 下载不全。
实操建议:
- 按
Ctrl+Shift+X打开扩展面板,卸载所有名称含“汉化”“中文”“Chinese”但发布者不是 Microsoft 的插件 - 重新搜索
Chinese (Simplified) Language Pack for Visual Studio Code,只认 ID 是ms-ceintl.vscode-language-pack-zh-hans、图标带蓝勾的那一个 - 安装后右下角必须出现 Restart Now 提示——没弹出来就等于没装成功,别继续下一步
- 仍无效时,在命令面板输入
Extensions: Show Installed Extensions,确认该插件状态为 Enabled
点了 zh-cn 重启后还是英文
语言包已装好,但 locale.json 没写对或没生效。VSCode 1.70+ 版本起,settings.json 里的 "locale": "zh-cn" 已被忽略,只读取用户级 locale.json 文件,且格式容错极低。
实操建议:
- 彻底关闭所有 VS Code 进程:
Windows查任务管理器中所有Code.exe;macOS用活动监视器杀掉Electron;Linux执行pkill code - 定位并编辑
locale.json:- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
- Windows:
- 文件内容必须严格为单行:
{"locale":"zh-cn"}(无空格、无 BOM、双引号为英文符号、结尾不加逗号) - 保存前确认编辑器右下角状态栏显示编码为
UTF-8,不是UTF-8 with BOM或GBK
部分菜单中文、部分仍英文或弹窗乱码
这是第三方插件污染了运行时环境,典型表现是命令面板空白、设置页文字错位、甚至出现广告链接。官方语言包机制是纯净覆盖,一旦混入非标准翻译资源,VSCode 就会 fallback 到英文或加载异常字符串。
实操建议:
- 立即禁用或卸载所有非 Microsoft 发布的中文相关插件,尤其是
Chinese Language Pack、VSCode Chinese等 - 执行
Developer: Reset Language Pack命令(需先确保官方包已启用) - 若重置无效,手动删除缓存:
%APPDATA%\Code\Cache(Win)、~/Library/Application Support/Code/Cache(macOS)、~/.config/Code/Cache(Linux) - 再全新启动 VSCode,仅装官方包 + 执行
Configure Display Language→zh-cn→Restart
远程开发(SSH/WSL)里中文不生效
Remote-SSH 或 WSL 环境下的 VSCode Server 是独立进程,它不读取本地 locale.json,也不共享主界面的语言配置。你在本地设好了,远程端仍是英文,这是设计如此,不是 bug。
实操建议:
- 连接远程主机后,在远程窗口中重复本地流程:安装
ms-ceintl.vscode-language-pack-zh-hans插件 - 在远程窗口中执行
Configure Display Language→ 选zh-cn→Restart - 或直接在远程端编辑其
locale.json(路径同本地,但位于远程系统对应位置),内容仍为{"locale":"zh-cn"} - 注意:远程端 VSCode Server 版本需 ≥ 1.70,否则可能不支持该配置方式
locale.json 却保存成了 GBK 编码,或者以为装了插件就万事大吉,结果命令面板根本没触发配置写入。


















