离线安装vscode插件必须同步满足版本、结构、依赖三重条件，缺一则功能静默失效；拖拽无反应需确认已加载工作区、窗口有焦点、文件为原始.vsix；报“not compatible”须比对code版本、engines字段及架构；lsp类插件需在有网机预触发并整目录迁移。
离线工作站上装 VSCode 插件，不是“拖进去就完事”，而是必须同步满足版本、结构、依赖三重条件，缺一不可；否则插件列表显示已安装，但 Python 补全、Rust 诊断、ESLint 校验全部静默失效。
拖拽 .vsix 到 VSCode 没反应？先确认这三件事
这是离线环境里最高频的“假失败”，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"}字段——^1.80.0表示最低要求1.80.0，你本地是1.79.2就会被跳过 - Help → About 里括号中的架构（
arm64/x64）是否与插件构建目标一致（ARM Mac 装 x64 版本的pyright会静默失败）
注意：GUI 拖拽完全不提示这类版本不匹配，而命令行会明确报错——所以排障优先用 code --install-extension。
插件显示“已安装”，但 Python/Rust/ESLint 功能不工作？大概率缺 LSP 服务
语言类插件（如 ms-python.python、rust-lang.rust-analyzer）安装只是注册，首次启用才拉 native 二进制依赖。离线时这些请求卡在 “Downloading…” 或直接 spawn ENOENT。
- 正确做法：在有网机器上完整走一遍流程——打开
.py文件 → 等状态栏变绿 → 确认 Output 面板中 Python 通道无报错 → 再拷整个扩展目录 - 路径要完整：
%USERPROFILE%\AppData\Roaming\Code\Extensions\ms-python.python-2024.6.0\（Windows）或$HOME/.vscode/extensions/ms-python.python-2024.6.0/（Linux/macOS） - 不能只拷
.vsix，也不能只拷node_modules；pyright-server、rust-analyzer这类二进制藏在子目录里，漏一个就功能残缺
企业级批量部署时，怎么避免漏掉隐式依赖
单个插件手动装没问题，但团队统一配置时靠人肉下载极易漏掉真实依赖：
- 别信插件页面写的 “Recommended” —— 那是推荐栏，不是依赖树
- 真实依赖藏在
.vsix解压后的package.json的extensionDependencies字段里 - 最稳方式：在已配好的联网机器上导出完整列表：
code --list-extensions > extensions.txt，再逐行用vsce download ms-python.python@2024.6.0下载对应.vsix - 策略禁用（
Extensions disabled by policy）时，GUI 和 CLI 全部失效，只能解压直投extensions目录，且必须彻底退出 VSCode（包括托盘进程）再重启
复杂点在于：LSP 类插件的 native 服务不是静态资源，它依赖运行时环境（Python 版本、glibc 版本、CPU 架构），同一份 .vsix 在不同离线机器上可能表现不一致——必须按目标环境逐台验证，不能只看安装成功与否。
