“not compatible with Code”错误需手动比对三处：①运行code --version取主版本号（如1.85.2→1.85）；②解压.vsix查extension/package.json中"engines.vscode"字段；③核对Help→About中架构（arm64/x64）是否匹配。
code --install-extension 报 “not compatible with Code” 怎么定位
这个错误只说明不兼容，但不会告诉你具体哪一环出问题。必须手动比对三处：
- 运行
code --version，取输出第一段（如1.85.2→1.85） - 解压
.vsix，打开extension/package.json，找"engines": { "vscode": "^1.80.0" }—— 你本地版本必须 ≥ 这个值 - Help → About 里括号中的架构（
arm64/x64）是否与插件构建目标一致；ARM Mac 装 x64 版本的插件会静默跳过 native 加载，不是报错，是功能缺失
注意：^1.80.0 表示最低要求 1.80.0，你本地是 1.79.2 就会被跳过——命令行会明确报错，GUI 拖拽则完全不提示。
拖拽 .vsix 到 VSCode 没反应？先确认这三件事
这不是插件坏了，是 VSCode 根本没收到安装信号。拖放失败几乎全是这三点没对齐：
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），纯启动页或远程 SSH 未连接完成时拖放会被静默忽略
- 窗口必须有系统焦点：任务栏图标高亮，且不能处于全屏、RDP 或 TeamViewer 等远程桌面状态（它们会拦截拖放事件）
- 拖的是原始
.vsix文件，不是解压后的文件夹、.zip、双后缀（如prettier.vsix.zip）或右键重命名生成的损坏包
验证方法：unzip -l your-extension.vsix 应显示顶层目录为 extension/，且含 extension/package.json；若报错或结构散乱，说明文件已损坏。
插件装上了，但 Python/Vue/C++ 补全不工作？缺的是 LSP 或 native 组件
很多插件（如 ms-python.python、volarjs.volar、ms-vscode.cpptools）安装只是注册前端，首次启用才下载语言服务器（pyright-server、volar-server、cpptools-srv），离线环境会卡在状态栏 “Downloading…” 或 Output 面板报 spawn ENOENT。
- 正确做法：在有网机器上完整触发一次——打开一个
.py或.vue或.cpp文件，等状态栏显示 “Ready” 后，再拷整个~/.vscode/extensions/ms-python.python-2024.6.0/目录（含子目录里的 native 二进制）到内网机对应路径下 - 不能只拷
.vsix，也不能只拷node_modules；native 二进制藏在子目录里（如dist/server/pyright），漏一个就启动失败 - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新
校验 .vsix 文件是否完整可用
VSCode 对 .vsix 校验极严：文件头错一位、多一个空格、被浏览器改名成 .vsix.zip，都会静默失败。
- Windows 下别右键“重命名”改后缀，用 PowerShell 执行：
Copy-Item "old.zip" "new.vsix" -Force - Linux/macOS 运行：
unzip -t your-extension.vsix，输出OK才算完整 - 用
unzip -l your.vsix看顶层目录是否含extension/package.json；若显示一堆零散文件，说明已解压或损坏 - 务必核对官网提供的 SHA256 哈希值（Marketplace 页面右下角小图标可展开）
真正卡住的地方往往不是操作步骤，而是版本、签名、LSP 三层嵌套依赖中任意一层没对齐——尤其容易忽略的是 native 组件的架构匹配和首次触发后的整目录迁移。
