VSCode中文界面失效的根本原因是未执行Configure Display Language命令并重启——必须通过Ctrl+Shift+P（或Cmd+Shift+P）调出命令面板，选择zh-cn后点击Restart，且locale.json路径和内容须严格正确，否则配置不生效。
VSCode装了中文插件但界面还是英文，基本就是没走对配置路径——不是插件没装上，而是编辑器根本没“决定”用它。
Configure Display Language 命令必须执行
VS Code 不会自动启用已安装的语言包，Configure Display Language 是唯一能写入生效配置的入口。跳过这步，装十遍插件也没用。
- 用
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入并执行
Configure Display Language - 在下拉列表中选
zh-cn，不是zh、Chinese或zh-hans - 弹出提示后必须点
Restart——仅关闭再手动打开不算重启，后台进程（如Code Helper）不退出会导致配置未加载
locale.json 文件位置和格式必须严格正确
VS Code 1.70+ 版本只认 locale.json 里的 {"locale": "zh-cn"}，其他地方写的 locale 都无效，包括 settings.json。
- 文件路径必须准确：
Windows：%APPDATA%\Code\User\locale.json
macOS：~/Library/Application Support/Code/User/locale.json
Linux：~/.config/Code/User/locale.json - 内容必须是合法 JSON：
双引号包裹、冒号后有空格、值为小写"zh-cn"（不是"zh_CN"或"zh-Hans"） - 如果该文件存在但值是
"en"或为空，可能是被工作区设置、远程开发环境或 IT 策略插件覆盖；可先File > Close Folder再执行命令绕过干扰
离线安装 vsix 包时版本必须匹配
从官网下载的 MS-CEINTL.vscode-language-pack-zh-hans-1.90.2.vsix 不能直接装进 1.91.0-insider，报 not compatible with Code 就是这个原因。
- 先用
unzip -l your-plugin.vsix确认根目录下有extension/package.json - 解压后修改
package.json中的"engines": {"vscode": "^1.85.0"}字段，改成你本地code --version输出的主版本号（如1.91.0→ 改成"^1.91.0"） - 重新打包必须用
zip命令或 7-Zip；Windows 资源管理器双击解压再重命名会破坏 ZIP 结构，导致安装静默失败
缓存残留或系统区域设置可能劫持启动逻辑
即使 locale.json 正确、插件也装好了，部分菜单仍显示英文，大概率是缓存没清干净，或者系统语言设置在底层覆盖了 VS Code 的启动判断。
- 尝试删除
~/.vscode下的Cache和CachedData目录（重启前） - 检查系统区域设置：Windows 控制面板 > 区域 > 管理 > 更改系统区域设置，确认不是强制设为英文
- macOS 上某些终端启动脚本（如
~/.zshrc）若设置了LANG=en_US.UTF-8，也可能影响 VS Code 启动时的语言探测
最常被忽略的一点：VS Code 的语言选择发生在进程启动初期，任何后续修改（比如改完 locale.json 后只关窗口不杀进程）都不会触发重载。必须彻底退出所有 VS Code 进程，再重新启动。否则你看到的永远是旧状态。
