弹窗报错但无具体信息，先确认VSCode是否真在加载.vsix：1.70+版本禁用双击安装，须用Ctrl+Shift+P→Install from VSIX；拖放失败常见于RDP/全屏/路径含中文；“corrupt”或“not compatible”实为package.json中engines.vscode版本不匹配，需校验并修正版本号后重新打包。
弹窗报错但没具体信息？先看 VSCode 是否真在加载 .vsix
VSCode 1.70+ 版本已禁用双击安装 .vsix 的方式，点击后无反应或弹窗一闪而过，大概率是它根本没进入解析流程。这不是网络问题，而是 UI 层直接跳过了处理逻辑。
- 别双击文件——必须通过命令面板：
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 选中文件 - 拖拽失败常见于远程桌面（RDP/TeamViewer）或全屏窗口下，任务栏图标未高亮时 VSCode 不接收拖放事件
- 路径含中文或空格时，Windows 下必须用英文双引号包裹完整路径，例如：
"D:\vscode ext\MS-CEINTL.vscode-language-pack-zh-hans-1.96.2.vsix"
报错 “Extension is corrupt” 或 “not compatible with Code”？核心是 package.json 版本不匹配
这不是文件损坏，而是 VSCode 启动时读取 extension/package.json 中的 "engines.vscode" 字段后主动拒载。本地 code --version 输出为 1.96.3，但包里写的是 "^1.90.0"，语义化版本不满足，就会静默失败。
- 用
unzip -l your.vsix确认根目录下有extension/package.json；若只有零散文件，说明已被错误解压 - 必须用
7-Zip或命令行解压，**不能用 Windows 资源管理器双击打开再保存**，否则 ZIP 结构破坏，导致安装无提示失败 - 编辑
extension/package.json，将"engines": {"vscode": "^1.90.0"}改为"engines": {"vscode": "1.96.3"}（填你本地完整版本号，不带^更稳妥） - 重新打包：Linux/macOS 用
zip -r new.vsix extension/；Windows 用 7-Zip → “添加到压缩包” → 格式选 ZIP → 后缀手动改为.vsix
装完仍弹窗报错或界面不变？locale.json 没写对或没生效
语言包只是“翻译素材库”，VSCode 只认 locale.json 文件里的 {"locale": "zh-cn"} 这一行。settings.json、命令面板模糊搜索、工作区配置都无效。
- 路径必须准确：
%APPDATA%\Code\User\locale.json（Windows）、~/.config/Code/User/locale.json（Linux）、~/Library/Application Support/Code/User/locale.json（macOS） - 内容必须是合法 JSON：
{"locale": "zh-cn"}—— 小写、短横线、双引号，zh_CN、zh-hans、Chinese全部无效 - 如果该文件存在但值是
"en"或为空，可能是被 Remote-SSH/WSL 的远程locale.json覆盖，或 IT 策略插件强制重写 - 改完后必须彻底重启：任务管理器杀光所有
Code.exe和Code Helper进程，再启动，否则旧进程缓存仍在
离线环境还报签名错误？不是证书问题，是校验流程卡死
VSCode 1.85+ 默认启用扩展签名验证，离线时无法联网校验，会卡在“Installing…”或直接报 Unable to load extension。这不是证书过期或篡改，而是校验请求发不出去后流程中断。
- 最安全绕过方式：临时关闭校验，在
settings.json加一行"extensions.installVerification": false，安装完成立即删掉 - 更推荐做法：断网启动 VSCode（拔网线 / 关 Wi-Fi），再执行
Extensions: Install from VSIX—— 此时它会跳过联网校验，直读本地包 - 注意：即使关了校验，
engines.vscode版本仍必须匹配，否则连本地加载都不触发
