vscode界面显示英文的主因是未装microsoft官方中文语言包、locale.json路径或内容错误、未彻底重启进程;需安装id为ms-ceintl.vscode-language-pack-zh-hans的插件,配置正确路径下的{"locale":"zh-cn"},并完全退出后重启。

VSCode界面显示英文,不是插件没装对,就是locale.json没写对或没生效——装完插件不重启、写错路径、用settings.json配locale,这三类操作占失败案例的90%以上。
怎么确认你装的是 Microsoft 官方中文语言包
搜“中文”“汉化”点安装,大概率踩坑。真正起作用的只有一个扩展:
- 完整名称必须是:
Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是:
Microsoft,ID 是ms-ceintl.vscode-language-pack-zh-hans - 别选
Chinese Language Pack、VSCode Chinese、带Pro或Ultimate字样的第三方包——它们不更新、不兼容,有的还会注入广告或乱码 - 如果搜不到,说明 VS Code 版本低于 1.13,需先升级
Configure Display Language 命令为什么必须执行
这个命令不是可选项,而是唯一能正确生成或写入 locale.json 的入口。手动往 settings.json 里加 "locale": "zh-cn" 完全无效(VS Code 1.70+ 已彻底弃用该字段)。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Configure Display Language并回车 - 在弹出列表中**只选
zh-cn**(小写、短横线、不能是zh_CN、zh-hans、Chinese) - 点
Restart,不是Developer: Reload Window——后者不重载语言环境
locale.json 文件必须严格满足这四个条件
VS Code 只读取用户级 locale.json,且内容格式容错极低。
- 路径必须准确:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json - 文件内容只能是合法 JSON,且仅含一行:
{"locale":"zh-cn"} - 编码必须是 UTF-8 无 BOM;多一个空格、少一个引号、写成
locale.language都会静默失败 - 改完后必须彻底退出所有 VS Code 进程(Windows 查任务管理器中的
Code.exe,macOS 查Electron),再重新启动
Remote-SSH / WSL 环境下中文不生效怎么办
本地设了中文,远程连接后还是英文?因为 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读的是远程机器上的 locale.json,和本地完全无关。
- 先确认远程 VS Code Server 已运行:
code --list-extensions - 进入远程配置路径:
~/.vscode-server/data/Machine/(后面可能带哈希后缀目录) - 在该目录下新建或编辑
locale.json,内容仅:{"locale":"zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window(不是本地窗口) - 如果用 Snap/Flatpak 安装的 VS Code,语言包大概率无法加载——换用 .deb 或官方 tarball 版本
真正起作用的只有三样东西:装对插件、locale.json 存在且内容合法、VS Code 进程是全新启动的。右下角状态栏显示 en 就说明没生效,此时直接点击它选 zh-cn 是最快兜底方式;但若反复失败,优先检查是否残留旧进程或误写了工作区级 .vscode/locale.json ——VS Code 1.70+ 不认这个路径。











