vs code 中文界面失效的主因是未执行 configure display language 命令并选 zh-cn 后重启；locale.json 文件缺失或错误、安装非官方插件、系统区域设置不匹配也会导致失败。
Configure Display Language 命令没执行或选错值
装了中文包但界面仍是英文，最常见原因就是跳过了这一步：插件只提供翻译资源，VS Code 不会自动启用它。必须显式调用 Configure Display Language 命令，并手动选中 zh-cn。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入并执行
Configure Display Language（注意不是“Change Language”或模糊匹配项） - 在下拉列表中**严格选择
zh-cn** —— 不是zh、zh-Hans或Chinese - 弹出提示后必须点
Restart，仅Reload Window无效；要彻底退出进程（包括托盘里的Code Helper）再重开
locale.json 文件缺失、格式错误或被覆盖
VS Code 实际只认 locale.json 里写的值，其他地方（比如 settings.json）写 "locale": "zh-cn" 完全无效。这个文件必须存在、路径正确、内容合法。
- 路径必须准确：
Windows：%APPDATA%\Code\User\locale.json
macOS：~/Library/Application Support/Code/User/locale.json
Linux：~/.config/Code/User/locale.json - 内容必须是合法 JSON：
{"locale": "zh-cn"}（双引号、冒号后有空格、值全小写、无多余逗号） - 如果文件不存在，说明
Configure Display Language从未成功执行；如果存在但值是"en"或为空，大概率被工作区设置、远程开发环境或 IT 策略插件覆盖 - 别手动生成该文件——它应由 VS Code 自己写入；若已手动创建，建议删掉，再运行命令让 VS Code 重建
装了非官方中文插件或版本不兼容
搜“中文”“汉化”很容易装到第三方插件，它们不维护、缺翻译项，甚至带广告。VS Code 只信任微软官方语言包 ms-ceintl.vscode-language-pack-zh-hans。
- 在扩展面板（
Ctrl+Shift+X）中精确搜索：Chinese (Simplified) Language Pack for Visual Studio Code（注意大小写和空格） - 确认发布者是 Microsoft，图标带蓝勾认证；卸载所有名字含“Chinese Language Pack”但发布者不是 Microsoft 的插件
- 安装后右下角必须出现
Restart Now提示——没弹出来基本等于没装成功 - 离线安装
.vsix包时，需检查package.json中的"engines": {"vscode": "^1.xx.0"}是否匹配你本地code --version输出的主版本号
系统区域设置或缓存干扰导致局部英文
即使 locale.json 正确、插件也启用，部分菜单仍显示英文，通常是因为系统语言 fallback 或缓存未刷新。
- Windows：检查「设置 > 时间和语言 > 语言 > Windows 显示语言」是否为「中文(简体,中国)」
macOS：「系统设置 > 语言与地区 > 首选语言」中「简体中文」是否排在顶部
Linux：终端执行locale，确认LANG含zh_CN - 改完系统语言后，仍需确保
locale.json存在且值为"zh-cn"，避免依赖系统 fallback - 打开输出面板（
Ctrl+Shift+U），选Log (Window)，搜索zh-cn或localization，看是否出现Loaded locale zh-cn from …；若报Failed to load localization，说明资源损坏，需重装 - Windows 上可尝试清缓存：
Ctrl+Shift+P→Developer: Toggle Developer Tools→ Console 执行location.reload()再重装插件
真正卡住人的地方，往往不是“不会装”，而是以为装完就自动生效，或者改了 settings.json 就算设好了。VS Code 的语言切换机制很干净——只靠一个文件、一个命令、一次彻底重启。其他所有操作，都是绕路。
