必须执行Configure Display Language命令并彻底重启VSCode,否则中文语言包不生效;该命令生成locale.json文件写入{"locale":"zh-cn"},且仅启动时读取一次。

装完中文语言包后界面仍是英文,不是插件没装好,而是 VSCode 没读到“用中文显示”这个指令——必须执行 Configure Display Language 命令并彻底重启,否则语言包永远不加载。
为什么装了语言包还不生效
VSCode 的语言包只是“翻译字典”,不自动启用。它不会监听你点了 Install 就立刻切换 UI,而是等你明确告诉它:“现在请用 zh-cn”。这个“告诉”的动作就是 Configure Display Language 命令。很多人卡在这一步:装完点右下角的 Reload Window,结果菜单栏、设置页、命令面板全还是英文——因为 Reload Window 只重载插件逻辑,不重建语言上下文。
- 语言包安装成功 ≠ 界面变中文;真正起效的是
locale.json文件里是否写入了{"locale":"zh-cn"} -
Configure Display Language命令的本质就是生成或修正这个文件 - 如果命令面板里搜不到该命令,基本可断定语言包根本没装上,或装完后没重启过任何窗口
正确触发中文生效的三步操作
顺序不能错,缺一不可:
- 确认已安装官方语言包:
Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是Microsoft,ID 是ms-ceintl.vscode-language-pack-zh-hans(名字带“汉化”“中文支持”的第三方插件一律跳过) - 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板,输入Configure Display Language(注意大小写和空格,不能缩写),回车后从下拉列表中严格选择zh-cn(不是zh_CN、zh-hans或Chinese) - 点击提示里的
Restart,然后**彻底退出所有 VS Code 进程**:Windows 查任务管理器中所有Code.exe,macOS 查活动监视器中的Electron,Linux 用pkill code;再全新启动
手动编辑 locale.json 强制生效
当命令面板打不开、UI 卡死、或批量部署时,直接改配置是最稳的兜底方式。VS Code 1.70+ 只读用户级 locale.json,且格式容错极低。
- 路径必须准确:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件内容只能是单行合法 JSON:
{"locale":"zh-cn"}(无空格、无 BOM、无逗号结尾、双引号必须是英文符号) - 别用记事本或 Sublime 编辑——保存时右下角状态栏必须显示
UTF-8,否则静默回退英文 - 改完后务必关闭所有进程再启动,否则旧进程会复用旧 locale
最常被忽略的一点是:VSCode 不会自动跟随系统语言,也不读 settings.json 里的 "locale" 字段(1.70+ 已弃用)。它只认 locale.json,且只在启动瞬间读一次。哪怕你改对了值,只要没杀干净后台进程,新窗口就可能继续用英文渲染——这不是 bug,是设计如此。


















