
装了中文插件但界面还是英文?不是插件坏了,是 VS Code 根本没被告诉“该用中文”——它默认只认操作系统语言或配置项,不自动切换。
为什么 Configure Display Language 是必走步骤
VS Code 的语言包(如 Chinese (Simplified) Language Pack)只是提供翻译资源的“素材库”,不会自动激活。真正控制界面语言的是 locale.json 配置文件,而修改它的唯一标准路径就是命令 Configure Display Language。
- 快捷键:
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS) - 输入后必须选中完整命令名:
Configure Display Language,不是“change language”或“set locale” - 在弹出列表中明确选择
zh-cn(不是zh、zh-TW或模糊匹配项) - 必须点击提示框里的
Restart按钮——仅重载窗口(Developer: Reload Window)无效
重启后仍有部分英文?检查 locale.json 文件是否被覆盖
VS Code 启动时会按优先级读取语言设置:命令面板设置 > 用户设置 > 操作系统区域。如果手动编辑过 locale.json,或某些脚本/工具(如多版本管理器、企业策略组)写入了冲突值,会导致切换失败。
- 该文件路径为:
$HOME/.vscode/locale.json(macOS/Linux)或%USERPROFILE%\AppData\Roaming\Code\User\locale.json(Windows) - 合法内容只应有:
{"locale":"zh-cn"}—— 多一个空格、逗号或引号都会让 VS Code 回退到英文 - 若文件不存在,VS Code 会用命令面板的选择自动生成;若存在但内容错误,优先级高于命令面板,必须手动修正
插件显示“已安装”却加载失败?看日志确认真实状态
网络中断、权限不足或杀毒软件拦截可能导致语言包下载不全,扩展管理器显示“已安装”,但关键翻译文件(如 package.nls.zh-cn.json)缺失。
- 打开输出面板:
Ctrl+Shift+U→ 选择Log (Window) - 搜索关键词:
localization或zh-cn,正常应看到类似Loaded locale zh-cn from … - 若出现
Failed to load localization或路径指向空目录,说明资源损坏,需卸载重装 - 重装前建议清缓存:
Ctrl+Shift+P→Developer: Toggle Developer Tools→ Console 里执行location.reload()再重装
最容易被忽略的点是:VS Code 的语言切换和插件启用是两套独立机制。即使你禁用了所有其他插件,只要没运行 Configure Display Language 并重启,中文就不会出现——这不是 Bug,是设计如此。











