离线安装VSCode插件必须满足版本、结构、依赖三重条件才真正生效；拖拽无反应需确认已加载工作区、窗口有焦点、文件为原始.vsix；报不兼容需比对code版本、package.json中engines字段及架构；LSP类插件需离线预拉取native服务；策略禁用时须解压直投extensions目录并彻底退出VSCode。
离线添加 VSCode 插件不是“凑合用”，而是必须严格满足版本、结构、依赖三重条件才能真正生效；装上≠能用，尤其对 Python、Rust、ESLint 这类带 LSP 的插件，漏掉 native 二进制或 language server 就会卡在“Downloading…”状态栏不动。
拖拽 .vsix 到 VSCode 主窗口没反应？先确认这三件事
这是离线场景下最常被误判为“安装失败”的情况，实际是环境未就绪：
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），纯启动页或远程连接未就绪时拖放会被静默忽略
- 窗口要有系统焦点：任务栏图标高亮，且不能处于全屏、RDP 或多显示器缩放偏移状态
- 拖的是原始
.vsix文件，不是解压后的文件夹、.zip、双后缀（如prettier.vsix.zip）或右键重命名生成的损坏包
验证方法：unzip -l your-extension.vsix 应显示顶层目录为 extension/，且含 extension/package.json；若报错或结构散乱，说明文件已损坏。
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 版本的pyright会静默失败）
注意：^1.80.0 表示最低要求 1.80.0，你本地是 1.79.2 就会被跳过——命令行会报错，但 GUI 拖拽完全不提示。
插件列表显示“已安装”，但 Python 补全/格式化不工作？大概率缺 LSP 服务
语言类插件（如 ms-python.python、rust-lang.rust-analyzer）安装只是注册，首次启用才拉 native 依赖。离线时这些请求会卡住或报 spawn ENOENT。
- 正确做法：在有网机器上完整走一遍流程——打开
.py文件 → 等状态栏变绿 → 确认 Output 面板中Python通道无报错 → 再拷整个扩展目录 - 路径要完整：
~/.vscode/extensions/ms-python.python-2024.6.0/（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Code\Extensions\ms-python.python-2024.6.0\（Windows） - 不能只拷
.vsix，也不能只拷node_modules；pyright-server、rust-analyzer这类二进制藏在子目录里，漏一个就启动失败
企业策略禁用扩展安装时，只能手动解压到 extensions 目录
当右下角出现 Extensions disabled by policy 提示，GUI 和 CLI 都会失效，此时唯一办法是拆包直装，但结构必须严丝合缝：
- 用
unzip -l xxx.vsix查顶层目录名（如ms-python.python-2024.6.0/），这就是扩展 ID + 版本，必须原样保留 - 解压后整个文件夹移入对应
extensions路径：
– Windows：%USERPROFILE%\.vscode\extensions\
– macOS/Linux：$HOME/.vscode/extensions/ - 复制完必须彻底退出 VSCode（包括托盘进程），否则缓存不刷新，插件不会被识别
这种方案绕过了签名校验，但插件无法自动更新，且部分依赖 node_modules 的插件可能运行异常——别指望它和在线安装效果完全一致。
