必须装Microsoft官方语言包MS-CEINTL.vscode-language-pack-zh-hans、执行Configure Display Language命令选zh-cn、彻底重启三者缺一不可;跳过任一环节或误装第三方插件,界面将卡在英文。

装对官方语言包、执行 Configure Display Language 命令、选 zh-cn 并彻底重启,三者缺一不可;跳过任一环节,或误装第三方“汉化插件”,界面就永远卡在英文。
只认 Microsoft 官方语言包 ID
VSCode 本身不带中文资源,必须靠扩展注入翻译。唯一有效的是 MS-CEINTL.vscode-language-pack-zh-hans 这个 ID 的扩展,发布者必须是 Microsoft。其他所有含“汉化”“一键”“中文支持”的插件,要么失效,要么污染命令面板(比如导致搜不到 Configure Display Language)。
- 在扩展面板(
Ctrl+Shift+X)中搜chinese,只点安装带蓝勾认证、名称为Chinese (Simplified) Language Pack for Visual Studio Code的那一项 - 装完右下角若弹出
Restart Now提示,必须点它——点Reload Window不生效 - 如果扩展图标变灰,说明被禁用,需手动启用
必须用 Configure Display Language 命令激活
语言包只是“备好字典”,VSCode 默认仍以英文启动。Configure Display Language 才是真正写入配置、触发加载的开关。它会生成或更新 locale.json 文件,而不是改 settings.json。
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language(注意:不含“中文”“change”“language pack”等词) - 回车后从列表中选
zh-cn(必须小写、带连字符;zh_CN、zh、Chinese全部无效) - 看到提示后务必点
Restart—— 不是Reload Window,后者不会重新初始化语言环境 - 如果选错导致
settings.json被写入"locale": "zh"这类无效值,需手动删掉该行再重试
远程开发(Remote-SSH / WSL)要单独配 locale.json
本地 VSCode 切成中文,不影响远程端的 VS Code Server。Remote-SSH 或 WSL 启动的是独立进程,它读取自己路径下的 locale.json,和本地配置完全隔离。
- 在远程终端中执行:
mkdir -p ~/.vscode-server/data/Machine/ - 然后创建文件:
echo '{"locale":"zh-cn"}' > ~/.vscode-server/data/Machine/locale.json - 保存后必须断开重连(或运行
code --remote-ssh-verbose触发重载),Reload Window无效 - 路径中的
Machine文件夹名可能因 VS Code Server 版本略有差异,如遇失败可先ls ~/.vscode-server/data/确认实际目录名
验证是否真生效,别被局部英文骗了
真正生效的标志只有三个地方全中文:顶部菜单栏(文件/编辑/视图)、命令面板提示文字(“请输入命令或搜索设置”)、设置界面左侧导航(用户/工作区/扩展)。其余区域显示英文属于正常现象。
- 终端、调试控制台、Git 输出、部分插件弹窗天然不走 VSCode 的 locale 配置,它们显示英文 ≠ 汉化失败
- 右下角状态栏仍显示
en?直接点击它,从下拉菜单选zh-cn是最快兜底方式 - 那个
Restart Now提示只出现一次,关掉后就不会再弹——后续想重试,必须手动进命令面板调Configure Display Language
最容易被忽略的其实是:插件装对了但没点重启、命令输成 Configure Language、选了 zh 而非 zh-cn、或者以为 Reload Window 就够了。这四件事只要做对,1 分钟内就能看到中文菜单。











