vs code 中文界面需安装官方中文语言包、执行 configure display language 命令设 locale 为 "zh-cn" 并彻底重启；仅装插件或改 settings.json 无效，因 1.70+ 版本只认 locale.json 配置。
Configure Display Language 命令没执行或选错值
VS Code 不会自动启用已安装的语言包，Configure Display Language 是唯一能写入生效配置的入口。跳过这步，装十遍中文包也没用。
常见错误包括：
- 只装了
Chinese (Simplified) Language Pack for Visual Studio Code插件，但没运行命令 - 在命令面板里输 “change language” 或 “set locale”，结果没找到正确命令
- 列表里选了
zh、zh-hans或Chinese—— 实际必须选zh-cn（全小写、短横线、不能是下划线） - 点了 Restart 提示框里的 “Cancel” 或直接关窗口，没点 “Restart” 按钮；仅
Developer: Reload Window无效
locale.json 文件缺失、格式错误或被覆盖
VS Code 实际只认 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"或"zh" - 如果该文件存在但值是
"en"或为空，说明被工作区设置、Remote-SSH/WSL 或 IT 策略插件覆盖；临时关闭文件夹（File > Close Folder）再执行命令可绕过干扰
扩展目录残留或缓存导致加载失败
卸载操作只是禁用，不会删磁盘文件。残留的旧语言包会和新版本冲突，触发 ERR_INVALID_LANGUAGE_PACK 或悬停提示空白。
要清理三层：
-
扩展目录：删掉
ms-ceintl.vscode-language-pack-zh-hans-*整个文件夹（Windows 在%USERPROFILE%\.vscode\extensions，macOS/Linux 在~/.vscode/extensions） -
settings.json：按
Ctrl+Shift+P→Preferences: Open Settings (JSON)，搜locale、language，删掉所有相关行（尤其注意工作区根目录下的.vscode/settings.json） -
缓存：完全退出 VS Code 后，删掉缓存目录（Windows：
%APPDATA%\Code\Cache；macOS：~/Library/Caches/com.microsoft.VSCode；Linux：~/.cache/Code）
离线安装 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 结构，导致安装静默失败
最容易被忽略的是：VS Code 的语言切换和插件启用是两套独立机制。即使禁用所有插件，只要没运行 Configure Display Language 并点 Restart，中文就不会出现——这不是 Bug，是设计如此。
