装对官方语言包并正确配置locale才是切换vscode中文界面的关键。需安装microsoft发布的chinese (simplified)语言包,再通过configure display language命令设locale为"zh-cn",最后重启;远程环境需单独配置。

装对语言包是前提,不是搜“中文”就行
第一次打开 VSCode 时界面默认英文,这不是 bug,是微软的主动设计。想切中文,第一步必须装 Microsoft 官方语言包,而不是随便点个“汉化插件”。常见错误是搜 Chinese 后点了第三方插件,比如名字带“Crack”“Plus”“Pro”的,这些不光无效,还可能污染扩展环境。
正确操作:Ctrl+Shift+X 打开扩展面板 → 搜索 Chinese (Simplified) Language Pack for Visual Studio Code → 只认发布者为 Microsoft、ID 是 MS-CEINTL.vscode-language-pack-zh-hans 的那一项 → 点安装。
- 装完右下角会弹提示,必须点
Restart Now,不是“Reload Window” - 如果没弹窗,说明安装失败或被拦截,可手动卸载重试
- Mac/Linux 用户注意:插件安装路径在用户目录下,无需管理员权限
Configure Display Language 命令才是开关
语言包只是“字典”,真正决定界面显示哪种语言的是配置项 locale。VSCode 不会自动把刚装的语言包设为当前语言,必须手动触发切换命令。
操作路径:Ctrl+Shift+P(Mac 用 Cmd+Shift+P)→ 输入 Configure Display Language(注意:别输“chinese”或“change language”)→ 回车 → 从列表里选 zh-cn(必须小写、带连字符,zh_CN 或 zh 都无效)→ 点 Restart。
- 如果命令面板里搜不到这个命令,基本就是语言包根本没装成功
- 选错后
settings.json可能被写成"locale": "zh"这类无效值,后续再选也不生效,得手动删掉这行 - 重启后状态栏右下角应显示
zh-cn,点开也应有对应语言选项
直接改 settings.json 最稳,但三处不能错
命令面板打不开、或执行了命令但重启还是英文?这时候绕过 UI,直改配置文件更可靠,但必须满足三个硬性条件:
- 打开的是用户级
settings.json:用Ctrl+Shift+P→Open User Settings (JSON),别去改工作区或默认设置 - 文件编码必须是 UTF-8 无 BOM,否则中文乱码或整行被忽略(VSCode 默认新建 JSON 就是这个编码,但用其他编辑器保存过就可能出问题)
- 只加或只改一行:
"locale": "zh-cn",已有该字段就只替换值,不要重复写 key
Linux 路径:$HOME/.config/Code/User/settings.json;macOS:$HOME/Library/Application Support/Code/User/settings.json。
Remote-SSH / WSL 下仍是英文?那是远程实例没配
本地设成 zh-cn,不代表连上去的远程机器或 WSL 里也生效。VSCode 的语言设置是分上下文的:本地窗口一个配置,远程 SSH 会话又是一个独立运行实例,它读的是远程环境里的 settings.json 和语言包。
- 进 Remote-SSH 后,按
Ctrl+Shift+P再执行一次Configure Display Language,选zh-cn - 确保远程机器上也安装了同款语言包(VSCode 会自动同步,但有时卡住,可手动在远程扩展面板里搜装一遍)
- 如果远程终端仍显示英文,检查远程系统的 locale 设置,比如 Linux 上运行
locale命令,确认LANG=zh_CN.UTF-8是否生效
最容易被忽略的是:语言包和 locale 配置必须同时存在且匹配,缺一不可。很多人只改了配置却忘了装包,或者装了包却没触发命令,结果反复折腾半天界面还是英文。











