必须执行configure display language命令并重启，locale.json路径、内容{"locale":"zh-cn"}及权限三者缺一不可；手动改settings.json无效，远程/工作区配置会覆盖用户级设置。
中文插件装了但界面还是英文，先看 locale.json 是否真实生效
装完 ms-ceintl.vscode-language-pack-zh-hans 后没变化，90% 是因为 VS Code 根本没读到正确的语言配置。它只认 locale.json 文件，且路径、内容、权限三者缺一不可。
- 路径必须精准：
%APPDATA%\Code\User\locale.json（Windows）、$HOME/Library/Application Support/Code/User/locale.json（macOS）、$HOME/.config/Code/User/locale.json（Linux） - 内容只能是严格 JSON：
{"locale":"zh-cn"}——不能多空格、不能用单引号、不能写成"zh_CN"或"zh-hans" - 文件必须由 VS Code 自己生成；手动创建或复制粘贴容易因 BOM、换行符或权限问题被忽略
- 若该文件存在但值不是
"zh-cn"，说明被工作区设置、远程环境或策略工具覆盖，需先关闭文件夹再执行命令
Configure Display Language 命令为什么总不生效
这个命令不是“可选操作”，而是唯一能触发 VS Code 写入并加载 locale.json 的入口。跳过它，装十遍插件也没用。
- 快捷键必须是
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入后**完整匹配**命令名：Configure Display Language - 列表里只选
zh-cn（小写、短横线），zh、Chinese、zh-hans都无效 - 弹出提示后必须点 Restart 按钮——
Developer: Reload Window不重载语言环境，托盘进程残留会导致配置不生效 - Remote-SSH / WSL 环境下要单独运行一次该命令，因为远程实例读的是
~/.vscode-server/data/Machine/下的独立locale.json
安装卡在 0%，不是网络慢，是本地防火墙静默丢包
进度条不动、Network 面板里请求长期停留在 stalled、浏览器能打开 marketplace 却在 VS Code 里失败——这基本就是 360、火绒、腾讯电脑管家等安全软件在劫持 HTTPS 流量。
- 打开
Developer: Toggle Developer Tools→ Network 标签页，点击安装中文包，观察第一个请求的 Timing：若一直卡在 stalled 且无后续阶段，就是本地拦截 - 临时验证方法：右键任务栏安全软件图标 → “彻底退出” → 杀掉所有
Code.exe和Code Helper.exe进程 → 重启 VS Code - 若仍卡住，检查
http.proxyStrictSSL是否为true；设为false可绕过非标证书校验，但仅限排查，勿长期开启 - 手动安装
.vsix后报 “Download failed”，其实是签名校验阶段被拦截，不是下载问题
离线安装中文包，版本和 ZIP 结构最容易翻车
从官网下载的 vscode-language-pack-zh-hans-1.90.2.vsix 直接装进 1.91.0 版本，会报 not compatible with Code——这不是兼容性 bug，是引擎版本字段硬校验失败。
- 先用
unzip -l your-plugin.vsix确认根目录含extension/package.json - 解压后修改
package.json中的"engines": {"vscode": "^1.85.0"}，改成你本地code --version输出的主版本号（如^1.91.0） - 重新打包必须用
zip命令或 7-Zip；Windows 资源管理器双击解压再拖回压缩，会破坏 ZIP 中央目录结构，导致静默失败 - 装完后务必打开
Output面板 → 选Log (Window)，搜索zh-cn，确认看到Loaded locale zh-cn from …
locale.json 被覆盖、被写错、被忽略，或者远程/本地环境混用却没意识到它们互不感知。
