vscode中文界面需安装microsoft官方简体中文语言包、执行configure display language命令设locale为"zh-cn"、并彻底重启，三者缺一不可；仅装插件或仅重载窗口无效，右下角显示en即未生效。
拖进VSCode窗口没反应，不是文件坏了
直接把 .vsix 文件拖到编辑器主区域却毫无反馈，99% 不是插件问题，而是环境卡住了。VSCode 对拖放非常挑剔，缺一不可：
- 必须已打开工作区（至少一个文件夹或文件），纯空白启动时拖放被静默忽略
- 窗口得有系统焦点：任务栏图标要高亮，不能被远程桌面（RDP/TeamViewer）、全屏应用或 macOS 多显示器缩放偏移遮挡
- 拖的是原始未解压的
.vsix文件——重命名过（如zh.zip改成zh.vsix）或用资源管理器双击解压再打包，都会破坏 ZIP 头，VSCode 读不到
验证方法：unzip -l your-file.vsix，输出第一行应为 extension/package.json 或类似结构；否则就是损坏了。
code --install-extension 报错“not compatible with Code”怎么修
这个错误只比对主版本号和架构，不看小版本，也不联网校验。报错说明 .vsix 里声明的最低要求超出了你本地 VSCode 的能力。
- 运行
code --version，取第一个小数点前的数字（比如1.90.2→1.90） - 解压
.vsix，打开extension/package.json，找"engines": {"vscode": "^1.85.0"}这行 - 若你本地是
1.90，但包里写的是^1.91.0，就得手动改——改成"^1.90.0"再重新打包为 ZIP，后缀改回.vsix - Windows 下别用资源管理器重命名，用 PowerShell：
Copy-Item old.zip new.vsix -Force
装完重启还是英文？检查 locale.json 和进程残留
安装语言包 ≠ 界面变中文。VSCode 必须同时满足三件事：插件已注册、locale 配置正确、启动时能加载对应资源。常见断点：
-
locale.json必须放在用户级路径：
Linux/macOS：~/.config/Code/User/locale.json
Windows：%APPDATA%\Code\User\locale.json
内容只能是：{"locale": "zh-cn"}（小写、连字符、双引号包裹）——zh-hans在部分版本（如 1.95+）会导致设置页仍为英文 - 改完文件必须保存为 UTF-8 无 BOM 编码，否则解析失败
- 重启前务必彻底退出 VSCode：关掉所有窗口 + 右下角托盘里的
Code Helper进程，否则缓存不刷新，新配置不生效
为什么官方包 ID 是 zh-hans，但配置却要写 zh-cn
这不是拼写习惯问题，是 VSCode 内部语言协商机制决定的。官方语言包 ID 是 ms-ceintl.vscode-language-pack-zh-hans，但主程序默认只把 zh-cn 当作简体中文的“显示语言标识”来触发完整 UI 替换。
zh-hans 虽然在某些场景能触发部分翻译，但它不参与标准 BCP 47 匹配流程，结果就是命令面板、调试面板、设置页等关键界面仍为英文——你看到的是“半汉化”，不是安装失败。
所以哪怕下载的是 vscode-language-pack-zh-hans-*.vsix，locale.json 里也必须写 "zh-cn"，且不能多空格、不能大写、不能漏引号。
