必须安装microsoft官方中文语言包并执行configure display language命令或手动配置"locale":"zh-cn"才能启用vscode中文界面,远程开发需额外在远程端配置locale.json。

装对语言包是前提,认准 Microsoft 官方 ID
VSCode 中文界面不是靠“汉化补丁”或第三方插件实现的,必须安装 Microsoft 官方发布的 Chinese (Simplified) Language Pack for Visual Studio Code。在扩展面板(Ctrl+Shift+X)中搜索 chinese,只认发布者为 Microsoft、ID 是 MS-CEINTL.vscode-language-pack-zh-hans 的那一项。装错插件(比如名字带“汉化”“中文支持”的非官方扩展)会导致命令面板搜不到 Configure Display Language,或者右下角状态栏始终显示 en。
Configure Display Language 命令才是生效开关
语言包只是“备好了翻译字典”,VSCode 默认仍以英文启动。真正切换语言靠的是内置命令 Configure Display Language,不是设置里点几下就能改的:
- 按
Ctrl+Shift+P(Mac 用Cmd+Shift+P)打开命令面板 - 输入
Configure Display Language(注意:不含“中文”“change”“chinese”等词) - 回车后选择
zh-cn(必须小写、带连字符,不能是zh_CN、zh或Chinese) - 弹出提示后点
Restart—— 不是Reload Window,后者不重新加载语言配置
选错后 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 场景需单独配 locale.json
远程开发时,本地 VSCode 界面变成中文,不代表远程端的 VSCode Server 界面也变。Remote-SSH 或 WSL 下的 VSCode Server 默认仍为英文,需要在远程机器上单独配置:
- 在远程端打开
~/.vscode-server/data/Machine/locale.json(路径可能因版本略有差异) - 确保内容为
{"locale":"zh-cn"} - 重启远程 VSCode Server(断开重连或运行
code --remote-ssh-verbose触发重载)
不配这个,你看到的远程终端、远程设置面板、远程调试器界面,依然全是英文——这点最容易被忽略,尤其团队协作时,别人截图里的菜单和你本地看到的不一致,往往就卡在这儿。











