VSCode中文界面必须安装Microsoft官方语言包ms-ceintl.vscode-language-pack-zh-hans,执行Configure Display Language命令选zh-cn并彻底重启;第三方插件无效,且Remote-SSH/WSL需单独配置远程端locale.json。

装对语言包:只认 Microsoft 官方那一款
VSCode 没有“中文版安装包”,所谓“汉化”本质是装一个官方语言扩展。搜 Chinese (Simplified) Language Pack for Visual Studio Code,必须认准发布者是 Microsoft、ID 是 MS-CEINTL.vscode-language-pack-zh-hans 的那一项。其他名字带“汉化”“中文支持”“一键汉化”的第三方插件,一律无效,还可能注入异常脚本导致菜单部分乱码或弹窗崩溃。
常见错误现象:
- 命令面板搜不到
Configure Display Language→ 基本就是装错了插件,或者根本没装成功 - 右下角状态栏仍显示
en,点开也无zh-cn选项 → 插件未被识别,需卸载重装
切换语言靠命令,不是改设置界面
locale 设置项只是个“存档位”,真正触发语言切换的是内置命令 Configure Display Language。它才是开关,语言包只是备好的字典。
操作要点:
- 按
Ctrl+Shift+P(Mac 用Cmd+Shift+P)打开命令面板 - 输入
Configure Display Language(注意:不含“中文”“chinese”“change”等词) - 回车后从列表选
zh-cn(必须小写、连字符,zh_CN、zh、Chinese全部无效) - 弹出提示后点
Restart—— 不是Reload Window,后者不重新加载语言资源
如果误选了 zh,settings.json 可能被写成 "locale": "zh" 这种无效值,后续再选也无效,得手动删掉这行再重试。
手动改 settings.json 失效?检查三处硬性条件
当命令面板打不开、或执行了命令但重启后仍是英文,直接改配置文件最稳,但必须满足三个前提:
- 打开的是用户级
settings.json:用Ctrl+Shift+P→Open User Settings (JSON),别去改工作区或默认设置 - 文件编码必须是 UTF-8 无 BOM,否则中文乱码或整行配置被忽略
- 只加一行:
"locale": "zh-cn";已有该字段就只改值,不要重复写 key
路径参考:
- macOS:
$HOME/Library/Application Support/Code/User/settings.json - Linux:
$HOME/.config/Code/User/settings.json
Remote-SSH / WSL 下仍是英文?那是远程端没配
本地设成中文,不代表远程实例也生效。Remote-SSH 或 WSL 连接后界面仍是英文,说明远程环境里没装语言包、也没配 locale.json。
解决方法:
- 在远程 VSCode 窗口中,同样执行
Configure Display Language命令并选zh-cn - 或在远程端的
~/.vscode-server/data/Machine/目录下手动创建locale.json,内容为{"locale":"zh-cn"} - 远程端也要装同一款 Microsoft 官方语言包,否则即使 locale 设对了,资源也加载不出来
很多人卡在这一步,以为本地配好了就万事大吉,其实 Remote 和 Local 是两套独立的语言环境,各管各的。











