VSCode界面未变中文的根本原因是locale.json配置未生效,必须确保安装Microsoft官方语言包(ID:ms-ceintl.vscode-language-pack-zh-hans),通过Configure Display Language命令严格选择zh-cn并重启,或手动创建符合路径与格式({"locale":"zh-cn"})的locale.json文件,且彻底退出所有进程。

VSCode 界面没变中文,不是插件没装好,而是 locale 配置没生效——装对插件只是第一步,真正起作用的是 locale.json 里那一行 {"locale": "zh-cn"},且必须满足路径、格式、重启三重条件。
必须认准 Microsoft 官方中文语言包
搜“中文”“汉化”出来的绝大多数插件都是无效甚至有害的。VS Code 只认一个 ID:ms-ceintl.vscode-language-pack-zh-hans,发布者必须是 Microsoft,全名是 Chinese (Simplified) Language Pack for Visual Studio Code。
- 别点
Chinese Language Pack、VSCode Chinese、Chinese Menu这类名字模糊的第三方包——它们只改菜单栏几个字,设置页和命令面板仍是英文,还可能覆盖翻译逻辑导致乱码 - 扩展图标要是蓝白 VS Code logo + 中文“中”字,其他一律不点
- 装完右下角弹出 “Reload Window” 提示,点它没用;必须执行下一步才能真正切换语言
Configure Display Language 命令必须选 zh-cn(小写+短横线)
这个命令不是“切换语言”的快捷入口,而是唯一能正确写入 locale.json 并触发 UI 重载的机制。输错名称、选错选项、跳过重启,都会导致静默失败。
- 快捷键是
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),不是Ctrl+P - 输入时要打全名:
Configure Display Language,缩写或拼错(如Configure Language)都搜不到 - 列表里出现的选项是代码值,不是文字描述:必须手动滚动找到
zh-cn,不能点zh、zh_CN、Chinese (Simplified)或任何带空格/下划线的变体 - 弹窗提示 “Restart to apply…” 时,必须点 是;点 “No” 或关掉窗口,配置根本不会写入
手动编辑 locale.json 是最稳的兜底方式
命令面板搜不到、列表为空、点了没反应——这些基本说明语言包没加载成功,或者 VS Code 没读到配置路径。此时直接编辑文件比反复重试更高效。
- 文件路径必须严格匹配:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
- Windows:
- 内容只能是合法 JSON,仅一行:
{"locale": "zh-cn"}(注意双引号、小写、短横线) - 不能有注释、不能多字段、不能漏逗号、不能写成
zh_CN或zh-hans - 保存后必须彻底退出所有 VS Code 进程:Windows 查任务管理器中是否还有
Code.exe,macOS 用活动监视器查Electron或Code Helper,Linux 执行killall -9 code
终端和调试控制台仍是英文属于正常现象
VS Code 主界面(菜单、侧边栏、设置页)能变中文,不代表所有子模块都走同一套语言逻辑。终端(Terminal)、调试控制台(Debug Console)、输出面板(Output)使用的是系统 locale 或 shell 环境变量,不继承 locale.json 设置。
- 这不是配置错误,也不影响编码功能
- 如果坚持要统一,需在系统级调整区域设置(Windows 控制面板 / macOS 系统设置 / Linux
LANG环境变量) - 某些 Snap 版或企业定制版 VS Code 会忽略
locale.json,可临时启动时加参数:code --locale=zh-cn
最容易被忽略的其实是“彻底重启”:关掉窗口 ≠ 退出进程,后台残留的 Code.exe 或 Electron 进程会让新配置完全不加载。验证是否生效,只看右下角状态栏是否显示 zh-cn —— 这个值才是真实生效的语言标识。











