必须执行configure display language命令生成{"locale":"zh-cn"}并彻底重启,因中文语言包仅提供翻译资源,不自动启用;settings.json中配置无效,locale.json才是唯一生效文件。

装完中文语言包后界面仍是英文,怎么办?
装完插件不等于界面变中文——Chinese (Simplified) Language Pack for Visual Studio Code只是提供了翻译资源,VS Code 默认仍用英文。必须显式设置 locale 值并彻底重启,否则菜单、设置页、命令面板全保持英文。
常见错误现象:Configure Display Language 命令搜不到、选了 zh-cn 但重启后还是英文、右下角弹出 “Reload Window” 提示却点了它。
- 安装时必须认准发布者是 Microsoft,扩展 ID 是
ms-ceintl.vscode-language-pack-zh-hans;搜 “chinese” 或 “汉化” 极大概率装错 - 装完别点右下角的 “Reload Window”,它只重载插件,不触发 locale 切换
- Windows 用户务必检查任务管理器里所有
Code.exe进程是否已结束;macOS 用户需在活动监视器中强制退出Electron相关进程
Configure Display Language 命令搜不到或没反应
这说明语言包根本没装成功,或 VS Code 没读到配置路径。此时别反复试命令面板,直接编辑配置文件更稳。
该命令本质就是打开 locale.json 文件,手动写入 {"locale":"zh-cn"} 即可生效。
- 路径要对:
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,否则配置不解析,甚至导致 VS Code 启动失败
为什么改了 settings.json 里的 "locale" 还是无效?
settings.json 不是控制界面语言的地方——那是 locale.json 的职责。settings.json 里加 "locale": "zh-cn" 完全无效,VS Code 会忽略它。
容易混淆的点:
• locale.json 控制 UI 语言(菜单、对话框、命令面板)
• settings.json 控制编辑器行为(缩进、字体、自动保存等)
• locale 字段只在 locale.json 中起作用
- 别把
locale写进settings.json,写了也白写 - 如果
locale.json不存在,就新建一个,不要试图用settings.json替代 - 改完
locale.json后,必须彻底退出 VS Code 再启动,不能只关窗口
验证中文是否真正生效,只看这三个地方
终端输出、Git 面板、调试控制台、部分插件 WebView 显示英文 ≠ 汉化失败。这些组件不走 VS Code 的 locale 机制,而是依赖各自实现。
真正有效的验证点只有三个,且必须同时满足:
- 顶部菜单栏:文件、编辑、视图、终端 → 是否为中文
- 命令面板:
Ctrl+Shift+P打开后,输入框上方是否显示「请输入命令或搜索设置」 - 设置界面:按
Ctrl+,打开 Settings,左侧导航栏是否为「常规」「编辑器」「工作台」等中文项
只要这三处全是中文,说明汉化已完成。其他位置的英文属于正常现象,不是配置问题。











