必须安装Microsoft官方中文语言包ms-ceintl.vscode-language-pack-zh-hans,执行Configure Display Language命令选zh-cn,并彻底重启进程;装错第三方插件或仅重载窗口会导致界面中英文混杂。

必须装 Microsoft 官方语言包,不是“汉化插件”
VSCode 本身不带中文界面,所有汉化都依赖 MS-CEINTL.vscode-language-pack-zh-hans 这个官方扩展。在扩展面板(Ctrl+Shift+X)里搜 chinese,只认发布者是 Microsoft、ID 完全匹配的那一项。其他名字含“汉化”“中文支持”“一键切换”的插件,要么翻译残缺,要么会污染 locale 配置,导致命令面板消失或菜单中英文混杂。
- 装错后常见现象:
Configure Display Language命令搜不到、右下角状态栏始终显示en、部分弹窗文字错位 - 安装完别点「Reload Window」——它不加载语言资源,只是重载已启用的扩展
- 右下角若弹出提示,必须点 Change and Restart,否则配置不会写入
Configure Display Language 是唯一生效开关
语言包只是“备好了字典”,真正让 VSCode 切换界面语言的,只有 Configure Display Language 这条命令。它会自动生成或更新 locale.json 文件,并确保值为 "zh-cn"(小写、带连字符,不能是 zh、zh_CN 或 Chinese)。
- 操作路径:
Ctrl+Shift+P→ 输入Configure Display Language→ 回车 → 选zh-cn→ 点 Restart - 如果点了
OK或关掉弹窗没重启,配置不会加载,界面仍为英文 - 选错一次可能导致
settings.json被误写成"locale": "zh",后续再选无效,需手动删掉该行
Remote-SSH / WSL 下中文不生效?远程端要单独配
本地 VSCode 设成中文,不影响 Remote-SSH 或 WSL 中运行的 VS Code Server。那个进程是独立启动的,有自己的语言配置文件,路径在远程机器上:
- Remote-SSH:
~/.vscode-server/data/Machine/locale.json - WSL:
~/.vscode-server/data/Machine/locale.json - 内容只需一行:
{"locale":"zh-cn"},保存后断开重连(不是 reload) - 如果远程端没这个目录,手动创建完整路径再放文件
验证是否真生效,别被假象骗了
重启后只看三处:顶部菜单栏(文件/编辑/视图)、命令面板提示语(打开 Ctrl+Shift+P 后第一行文字)、设置界面左侧导航(用户/工作区/扩展)。这三处是中文,才算成功。
- 终端、调试控制台、Git 输出、部分插件弹窗显示英文,是正常行为,不是配置失败
- 右下角状态栏仍显示
en?直接点击它,在下拉菜单里选zh-cn是最快兜底方式 - 最常卡住的其实是:插件装错、命令输成
Configure Language、选了zh而非zh-cn、点了 reload 没点 restart


















