VSCode中文界面失效的根源是语言包、locale配置或进程未彻底重启三者之一出错;必须安装Microsoft官方简体中文语言包,配置独立locale.json文件并杀净后台进程。

VSCode中文界面没生效,不是插件装错了就是 locale 没设对,或者进程没彻底重启——三者里只要一个不到位,就永远显示英文。
Configure Display Language 命令点完没反应?先确认语言包装对了
搜“chinese”大概率装错,真正有效的只有 Microsoft 官方扩展:Chinese (Simplified) Language Pack for Visual Studio Code,ID 必须是 ms-ceintl.vscode-language-pack-zh-hans。其他名字带 Chinese 的,比如 Chinese Language Pack 或 VSCode Chinese,只改菜单栏几个字,不翻译设置页、命令面板和错误提示,还可能覆盖默认文案引发乱码。
- 打开扩展面板(
Ctrl+Shift+X/Cmd+Shift+X),搜索完整名称,别只输chinese - 认准发布者是
Microsoft,图标是蓝白 VS + 蓝勾认证 - 安装后右下角弹出
Restart Now提示,必须点它;点Reload Window不生效
点了 zh-cn 还是英文?检查 locale.json 是否写对位置和格式
settings.json 里写 "locale": "zh-cn" 已被 VS Code 1.70+ 彻底弃用,静默忽略。真正起作用的是独立的 locale.json,且只读用户级路径:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
该文件内容**仅且只能有一行**:{"locale":"zh-cn"}(双引号、全小写、连字符、无空格、无 BOM、无注释、无多余逗号)。
如果手动编辑过,建议删掉整个文件,再用命令面板运行 Configure Display Language → 选 zh-cn → 点 Restart,让 VS Code 自动重建。
重启后右下角还是显示 en?说明进程没杀干净
VS Code 的语言环境绑定到进程实例。旧窗口没完全退出,后台残留 Code.exe(Windows)、Electron(macOS)或 code(Linux)进程,新窗口会继承旧状态。
- Windows:打开任务管理器,结束所有
Code.exe进程 - macOS:活动监视器里查
Electron和Code Helper,全部退出 - Linux:执行
pkill -f "code.*--no-sandbox" - 再全新启动 VS Code,不是
Reload Window
远程开发(WSL / Remote-SSH)中文不生效?本地设置完全无效
Remote-SSH 和 WSL 启动的是远程机器上的 VS Code Server 实例,它读的是远程路径下的 locale.json,和本地配置无关。
- 先在远程终端执行
code --list-extensions,确认语言包已安装 - 进入远程配置路径:
~/.vscode-server/data/Machine/xxx/locale.json(xxx是哈希目录名) - 新建或编辑该文件,内容仅一行:
{"locale":"zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window
最常被忽略的是:locale.json 必须在用户级路径,不能放在项目目录或工作区 .vscode/ 下;哪怕内容完全正确,放错位置就等于没写。











