vscode中文界面需同时满足四条件:彻底终止所有进程、locale严格设为"zh-cn"、通过命令面板安装并配置语言包、远程环境单独部署。任一环节缺失均导致英文界面。

“Restart Now”点完没变化?进程根本没退出干净
VSCode 的 Restart Now 只是软重启,常残留 Code.exe(Windows)或 Electron(macOS/Linux)进程,新窗口仍读旧 locale 缓存。右下角弹窗点了“Restart Now”却还是英文,大概率是后台进程卡着没释放。
必须手动清空全部 VSCode 进程:
- Windows:打开任务管理器 → 搜索并结束所有
Code.exe进程(包括 GPU、Utility、Renderer 等子进程) - macOS:活动监视器 → 搜索
Code→ 全部强制退出(不只是关闭窗口,要 Quit) - Linux:终端执行
pkill -f "code.*--ms-enable-electron-run"或killall code
清完再双击图标或运行 code 命令启动,才是真重启。
locale 必须写成 "zh-cn",大小写和符号错一个都不行
VSCode 只识别全小写、短横线连接的 "zh-cn"。写成 "zh-CN"、"zh_CN"、"zh-hans" 或 "Chinese" 都会 fallback 到英文,且不报错、无提示。
验证方式:
- 按
Ctrl+Shift+P→ 输入Preferences: Open Settings (JSON) - 确认存在且唯一一条:
"locale": "zh-cn"(前后无多余空格,结尾有逗号) - 路径优先级:用户级
settings.json(%APPDATA%\Code\User\settings.json或~/.config/Code/User/settings.json)生效,工作区设置不覆盖它
安装完.vsix 不等于启用,必须走 Configure Display Language
离线拖拽或双击 .vsix 文件,VSCode 自 1.70 起已禁用该方式——文件被复制进 ~/.vscode/extensions/ 目录,但未注册扩展 ID,状态栏仍显示 en,命令面板搜不到 Configure Display Language。
正确流程只有这一条路径:
-
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 选中vscode-language-pack-zh-hans-*.vsix(发布者必须为MS-CEINTL)→ 点 Install - 装完立刻再
Ctrl+Shift+P→ 输入Configure Display Language→ 明确选zh-cn→ 点 Restart(不是 Reload Window) - 若命令面板搜不到该命令,说明插件未注册成功,需先卸载再重走上面两步
远程开发环境要单独配,本地装了对 SSH/WSL 窗口完全无效
你在本机装好中文包,连上远程机器后界面仍是英文——这不是同步问题,而是远程端 VSCode Server 完全独立,必须在目标环境重复部署。
操作要点:
- 点击右下角状态栏
SSH: xxx→ 选择Install 'Chinese (Simplified) Language Pack' in SSH: xxx - 安装完成后,同样要
Ctrl+Shift+P→Configure Display Language→ 选zh-cn→ Restart Remote Window - 若远程无图形界面(如纯 Linux 服务器),需手动编辑
locale.json:
Linux 路径:~/.vscode-server/data/Machine/locale.json
Windows 远程:%USERPROFILE%\AppData\Roaming\Code\User\locale.json
内容仅一行:{"locale":"zh-cn"}
真正卡住的往往不是不会装,而是没意识到:语言包注册、locale 设置、进程清理、远程隔离,这四件事缺一不可。任何一个环节跳过,界面就永远停在英文。











