vscode默认英文界面需手动安装microsoft官方简体中文语言包并执行configure display language命令切换,第三方汉化插件无效且易致乱码;远程环境(ssh/wsl)须单独配置。

VSCode 默认不带中文界面,装完就是英文,这不是你下错了包,也不是系统问题——它压根就没打算自动切中文。必须手动装官方语言包 + 显式切换 locale 才能生效,缺一不可。
必须用 Microsoft 官方语言包,第三方“汉化插件”一律无效
在扩展面板(Ctrl+Shift+X)中搜索 Chinese (Simplified) Language Pack for Visual Studio Code,只认发布者是 Microsoft、ID 是 MS-CEINTL.vscode-language-pack-zh-hans 的那一项。其他名字带“汉化”“中文支持”“一键汉化”的插件,不是失效,就是注入异常脚本导致菜单部分乱码或弹窗崩溃。
- 装错后常见现象:
Configure Display Language命令在命令面板里搜不到 - 右下角状态栏始终显示
en,点开也无zh-cn选项 → 插件未被识别,需卸载重装 - 菜单一半中文一半英文,或设置面板出现方块乱码 → 第三方插件污染了运行时,建议彻底卸载并重启 VSCode
切换语言靠 Configure Display Language,不是改 settings.json 就完事
语言包只是“备好了字典”,真正开关是内置命令 Configure Display Language。它会写入 locale.json(不是 settings.json),并触发完整重启加载流程。
- 快捷键打开命令面板:
Ctrl+Shift+P(Mac 用Cmd+Shift+P) - 输入
Configure Display Language(注意:不含“中文”“change”“chinese”等词,别拼错) - 回车后从列表选
zh-cn(必须小写、连字符,zh_CN、zh、Chinese全部无效) - 弹出提示后点
Restart—— 不是Reload Window,后者不重载语言资源 - 如果误选成
zh导致后续失效,需手动删掉$HOME/.config/Code/User/locale.json(Linux/macOS)或%APPDATA%\Code\User\locale.json(Windows)再重试
Remote-SSH / WSL 下仍是英文?那是远程端没配
本地设成中文,不影响 SSH 连上去的远程实例。Remote-SSH 或 WSL 环境有自己独立的 locale.json,必须在远程窗口里单独执行一遍 Configure Display Language 并重启远程窗口。
- 远程窗口右下角状态栏若仍显示
en,说明远程端语言配置未生效 - 不能靠复制本地
locale.json到远程路径解决,因为 Remote-SSH 启动的是独立进程,配置必须在远程上下文中触发 - WSL 中若用
code .启动,确保已安装 WSL 版 VSCode Server,否则语言包根本不会下载到远程
改 settings.json 手动加 "locale": "zh-cn" 失效?检查这三点
仅当命令面板打不开或反复失败时才建议手动改配置,但必须满足三个硬性条件:
- 改的是用户级
settings.json:用Ctrl+Shift+P→Open User Settings (JSON),别去碰工作区或默认设置 - 文件编码必须是 UTF-8 无 BOM,否则整行被忽略或引发乱码;可用 VSCode 自带编码切换功能(右下角点击编码名 → Save with Encoding → UTF-8)
- 只写一行:
"locale": "zh-cn";已有该字段就只改值,不要重复 key,也不要加逗号导致 JSON 解析失败
Remote 场景下,这个配置只影响本地主窗口,对远程编辑器无效——那是另一个世界的事。











