必须执行configure display language命令并选zh-cn才能激活中文界面，因插件仅提供翻译资源而不自动启用；1.70+版本弃用settings.json中的locale字段，仅认用户级locale.json文件，且内容必须为{"locale":"zh-cn"}，远程开发需单独配置。
装完中文语言包界面还是英文，90% 是因为根本没激活 locale，不是插件没下下来。 VS Code 不会自动启用已安装的语言包，必须显式告诉它“请用简体中文”，否则插件只是静静躺在磁盘上。
Configure Display Language 命令无效或找不到
这个命令是唯一能写入生效配置的入口，搜不到或执行后无反应，说明底层环境异常：
- 检查扩展面板里是否真有
ms-ceintl.vscode-language-pack-zh-hans—— 名字带“Chinese Language Pack”但发布者不是 Microsoft 的，一律停用 - VS Code 版本低于 1.70 会不识别新语言包格式，运行
code --version确认；旧版需手动改locale.json - 如果曾用
sudo code启动过，~/.vscode目录可能属 root，导致命令无法写入配置，运行sudo chown -R $USER:$GROUPS ~/.vscode（macOS/Linux）修复
locale.json 文件缺失、格式错误或被覆盖
VS Code 实际只读取该文件里的 {"locale": "zh-cn"}，其他地方写的 locale 都无效：
- 路径必须准确：
%APPDATA%\Code\User\locale.json（Windows）、~/Library/Application Support/Code/User/locale.json（macOS）、~/.config/Code/User/locale.json（Linux） - 内容必须是合法 JSON：双引号、冒号后有空格、值为小写
"zh-cn"（不是"zh_CN"、"zh-Hans"或"zh"） - 若文件存在但值是
"en"或为空，说明被工作区设置、Remote-SSH 环境或 IT 策略插件覆盖；临时关闭文件夹（File > Close Folder）再执行命令可绕过干扰
离线安装 .vsix 提示 “not compatible with VS Code”
错误信息含 ms-ceintl.vscode-language-pack-zh-hans 和 not compatible with VS Code '1.xxx'，本质是 engines.vscode 字段版本声明不匹配：
- 用 7-Zip 或
unzip解压 .vsix，进入extension/package.json（注意不是根目录那个） - 找到
"vscode": "^1.103.0"这类字段，改为当前版本兼容范围，例如："vscode": ">=1.85.0"或"vscode": "^1.90.0"（以code --version输出为准） - 保存后重新打包为 zip，后缀改回
.vsix，再通过命令面板执行Extensions: Install from VSIX
装了多个中文包导致界面乱码或变英文
VS Code 只允许一个 zh-cn locale 生效，多个包会互相覆盖或静默失败：
- 打开命令面板，执行
Configure Display Language，若列表中出现多个zh-cn选项，说明已安装重复包 - 在扩展面板搜索
chinese，停用所有非ms-ceintl发布者的中文语言包（尤其避开名称含 “Language Pack” 但作者不是 Microsoft 的） - 只保留
Chinese (Simplified) Language Pack for Visual Studio Code，重启后检查右下角是否显示「简体中文」
真正难排查的是“半截乱码”：菜单栏中文正常，但设置页某个开关 label 是方块——这往往不是语言包问题，而是字体链缺等宽中文字体，得回头调 editor.fontFamily，而不是继续折腾插件。
