必须安装 microsoft 官方的 chinese (simplified) language pack for visual studio code 插件,并严格配置 locale.json 为 {"locale": "zh-cn"} 且置于用户级路径,再彻底重启 vs code 才能生效。

装错插件名会导致界面不生效
搜“中文插件”大概率装错,VS Code 只认 Chinese (Simplified) Language Pack for Visual Studio Code 这一个扩展,发布者必须是 Microsoft。名字带“汉化”“中文语言包”“VSCode Chinese”的第三方插件,要么已失效,要么干扰更新,甚至可能阻止官方语言包加载。
- 在扩展面板(
Ctrl+Shift+X)里,**完整输入**:Chinese (Simplified) Language Pack for Visual Studio Code(注意括号、空格、大小写) - 图标是蓝白 VS 标志,右下角有 Microsoft 徽章 —— 别点搜索结果里排第一但名字只有
Chinese Language Pack的那个 - 安装后右下角弹出提示:“Language changed to Chinese (Simplified). Reload window to apply?” → 此时别急着点 Reload,先确认配置是否到位
locale.json 写错格式或路径就等于没配
locale.json 是唯一生效的语言配置文件,值必须严格为 "zh-cn"(小写、短横线、双引号包裹),写成 zh_CN、zh-hans、zh 或漏掉引号,VS Code 都会静默回退到英文,且不报错。
- 正确路径只有一处:
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"},不能多逗号、不能嵌套在其他字段里 - 如果多个路径下存在
locale.json(比如工作区或便携版目录里也有),删掉非用户级的,否则会被覆盖
“重载窗口”不等于“重启”,语言环境不会刷新
Developer: Reload Window 只刷新 UI 组件,不重载语言运行时;必须彻底退出 VS Code 进程,再重新启动,否则永远卡在英文界面。
- Windows:任务管理器中确认所有
Code.exe进程已结束 - macOS:活动监视器中检查
Electron进程是否清空 - 更稳妥的做法:终端执行
code --locale=zh-cn启动,验证是否生效;若成功,说明是缓存或进程残留问题
命令面板切换语言比手动改文件更可靠
用 Ctrl+Shift+P 执行 Configure Display Language 命令,选 zh-cn,它会自动创建或修正 locale.json,避免手误。这个命令在几乎所有版本中都可用,且绕过路径判断逻辑,适合排查配置文件被误删或权限异常的情况。
- 执行后会弹出确认框,点击“是”即可 —— 它比直接编辑
settings.json更安全,因为settings.json里写"locale": "zh-cn"是无效的 - 如果命令面板里搜不到该命令,说明语言包根本没装成功,或者插件被禁用,先去扩展面板检查状态











