错误本质是插件.vsix中package.json的"engines.vscode"字段版本范围与本地VS Code版本不匹配或格式异常；需解压检查并修正为兼容的明确版本号如"^1.90.0"。
code --install-extension 报 “not compatible with Code” 怎么快速修
错误本质是 .vsix 内部 extension/package.json 的 "engines": {"vscode": "^1.85.0"} 与你本地 code --version 输出的版本不满足语义化匹配。比如你装的是 VS Code 1.90.2，但插件只声明支持 ^1.85.0——理论上兼容，但某些旧版打包工具生成的字段格式（如多空格、换行、引号不一致）会导致 VS Code 拒绝解析。
实操建议：
- 用
unzip -l your-plugin.vsix确认根目录下有extension/package.json；没有则文件已损坏或被错误解压 - 解压后打开
extension/package.json，把"engines": {"vscode": "^1.85.0"}改成明确范围，例如"^1.90.0"或宽松写法=1.90.0 <1.91.0" - 重新打包必须用标准 ZIP 工具：Windows 推荐
7-Zip或 PowerShellCompress-Archive；别用资源管理器右键“发送到 → 压缩文件夹”，会破坏 ZIP 结构 - 重命名时用
Copy-Item "old.zip" "new.vsix" -Force（PowerShell），而非手动改后缀，避免文件头污染
拖拽 .vsix 到 VSCode 窗口没反应
这不是 UI 卡顿，而是 VS Code 根本没触发安装逻辑。拖放安装有三个硬性前置条件，缺一不可。
常见卡点：
- VS Code 必须已加载工作区（哪怕只是空文件夹），纯欢迎页（Welcome Page）不响应拖放
- 窗口必须处于系统焦点状态：任务栏图标高亮、非最小化、未被远程桌面（RDP/TeamViewer）或全屏应用遮挡
- 拖入的必须是原始
.vsix文件——用unzip -t xxx.vsix校验完整性；若提示 “missing 123456 bytes”，说明下载不完整 - macOS 用户注意：Safari 下载可能自动生成
._xxx.vsix隐藏文件，需用dot_clean .清理同级目录
插件装上了，但 Python/Vue/C++ 功能不工作
离线环境里，“安装完成” ≠ “可用”。多数主流插件（如 ms-python.python、volarjs.volar、ms-vscode.cpptools）只靠 .vsix 只注册前端界面，真正的语言服务（LSP）是首次启用时动态下载的。
关键动作：
- 在有网机器上完整走一遍流程：打开一个
.py文件 → 等状态栏显示 “Python extension activated” → 查看输出面板 “Python” 通道确认无报错 → 此时~/.vscode/extensions/ms-python.python-2024.6.0/目录下才真正包含out/、dist/和平台相关二进制（如pyright-server） - 整目录复制（不是只拷
.vsix）到内网机对应路径，覆盖前先彻底退出 VS Code（包括右下角托盘里的Code Helper进程） - ARM Mac 用户额外检查：
package.json中"os"字段是否含"darwin-arm64"；x64 构建的插件在 M 系列芯片上会静默跳过 native 加载，无报错但功能缺失
中文语言包离线安装后仍是英文
不是插件没装，是 VS Code 启动时没加载或拒绝激活。中文包（MS-CEINTL.vscode-language-pack-zh-hans）依赖内置 vs/nls.js 模块，而该模块在 VS Code ≤1.75 中默认关闭。
排查顺序：
- 删掉
settings.json里手动写的"locale": "zh-cn"——合法值只有"zh-hans"，写错直接被忽略 - Windows 上若系统区域设为英语且启用了 “Beta: Use Unicode UTF-8 for worldwide language support”，会绕过语言包加载；临时切回 “Chinese (Simplified, China)” 再试
- macOS/Linux 检查终端执行
echo $LANG，若输出en_US.UTF-8，启动 VS Code 前先运行LANG=zh_HANS.UTF-8 code - 双击桌面快捷方式可能拉起旧版实例；用任务管理器杀光所有
Code.exe和Code Helper，再从开始菜单启动
最常被忽略的一点：语言包不是独立插件，它不提供功能，只提供翻译字符串。一旦 vs/nls.js 没注入，或者 locale 配置值被 VS Code 自动修正为无效值，整个链路就断在第一步——连错误日志都不会输出。
