VS Code界面仍为英文是因为未正确配置中文语言包:必须安装Microsoft官方简体中文包,通过Configure Display Language命令手动选择zh-cn并重启,且locale.json文件需严格符合路径和JSON格式要求。

装了中文语言包但界面还是英文,基本可以断定:VS Code 根本没读到或没认你装的包——不是插件坏了,是它压根没被“告诉”该用中文。
确认装的是 Microsoft 官方中文语言包
第三方汉化插件只会改菜单栏几个字,命令面板、错误提示、设置项全还是英文,还可能报 Cannot read property 'translate' of undefined。
- 打开扩展面板:
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS) - 搜索框里**完整输入**:
Chinese (Simplified) Language Pack for Visual Studio Code(注意括号、空格、大小写) - 只认发布者为
Microsoft、扩展 ID 是ms-ceintl.vscode-language-pack-zh-hans的那一项 - 别点
Chinese Language Pack、VSCode Chinese或任何带 “Pro”“Menu”“Lite” 的包
Configure Display Language 命令必须选对值并彻底重启
这个命令不认 简体中文、zh_CN、zh-Hans,只严格匹配 BCP 47 标准值 zh-cn(全小写、短横线、无空格)。输错或点错,就静默失败。
- 按
Ctrl+Shift+P打开命令面板,输入并执行Configure Display Language - 从下拉列表中**手动滚动找到并点击
zh-cn**,不是靠关键词匹配,也不是点“简体中文”文字项 - 弹出提示后必须点
Restart——Reload Window不会重读语言配置,无效 - 如果命令面板里根本搜不到这个选项,大概率是语言包没装成功,或 VS Code 没加载到扩展(可关掉所有窗口后重开再试)
检查 locale.json 是否存在、路径正确、内容合法
VS Code 实际只认这个文件,且只在特定路径、特定格式下才生效。手动生成、放错位置、写错格式,都会静默 fallback 到英文。
- 文件路径必须严格匹配:
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"}(双引号、小写、短横线,无注释、无多余字段、无 BOM) - 文件不存在 → 说明
Configure Display Language从未成功执行
文件存在但值不是"zh-cn"→ 被工作区设置、远程开发环境或脚本覆盖
文件权限为只读(尤其 WSL 或远程挂载场景)→ 需chmod 600 locale.json
更新后中文消失?优先检查 settings.json 合法性
VS Code 1.80+ 对 JSON 合法性校验更严格,settings.json 里有注释、大小写错误(如 "zh-cn" 应为 "zh-CN")、末尾逗号或中文引号,会导致整个文件被跳过,回退英文界面。
- 用
Ctrl+Shift+P→Preferences: Open Settings (JSON),清空内容只留{},保存重启;若变纯英文默认,说明原文件确实被忽略 - 只保留这一行有效配置:
"locale": "zh-CN"(注意大写 CN) - 删掉所有注释、多余逗号、非双引号字符
- 保存后必须彻底退出 VS Code(任务管理器确认
Code.exe进程完全退出),再重启
最常被忽略的一点是:工作区级配置(.vscode/settings.json)和远程开发实例(SSH/WSL)完全独立,它们不继承本地设置,也不读本地 locale.json。关掉当前文件夹再试一次,往往就能定位是不是被工作区配置覆盖了。


















