离线安装VSCode插件失败主因是依赖缺失或版本不兼容：需确保已加载工作区、VSCode前台聚焦、未被组策略禁用；检查插件engines版本匹配、extensionKind/os适配；含LSP或CLI的插件须先联网完整运行再迁移node_modules；解压安装时目录名须规范且覆盖全局Extensions路径并彻底退出VSCode。
离线安装 VSCode 插件本身不难，难的是装完不能用——尤其当你以为“拖进去就完事”，结果 Python 插件卡在 Downloading...、Prettier 格式化按钮灰掉、或者 Snippets 生成器压根不响应时，问题几乎都出在「依赖没带全」或「版本校验过早失败」上。
拖拽 .vsix 到窗口没反应？先确认这三件事
VSCode 对拖放安装的触发条件很具体，不是所有“开着编辑器”的状态都能响应：
- 必须已加载一个工作区（哪怕只是空文件夹），纯欢迎页（Welcome Page）不支持拖放
- VSCode 窗口需处于前台且有焦点；远程 SSH 连接未就绪、多显示器缩放偏移、全屏模式下常被拦截
- 右下角状态栏若显示
Extensions disabled by policy，说明企业组策略已禁用全部扩展安装，拖拽和命令行都会静默失败
code --install-extension 报错 “not compatible” 怎么快速定位
这个错误不是模糊提示，而是 VSCode 在读取 .vsix 内部 package.json 后立刻拒绝安装。关键看两个字段：
-
"engines": { "vscode": "^1.80.0" }：你本地运行code --version，取前两位（如1.85.2→1.85），必须 ≥ 插件声明的最低版本 -
"extensionKind": ["ui", "workspace"]或"os": ["win32", "darwin"]：ARM Mac 装了 x64 编译的插件（尤其是含 native binary 的，如esbuild、pyright）会直接跳过加载，无报错
验证方法：unzip -p your-extension.vsix extension/package.json | grep -E "(engines|os|extensionKind)"（Linux/macOS）；Windows 可用 7-Zip 直接打开查看。
Snippets Generator 类插件离线后无法生成？其实是缺 LSP 或 runtime
像 Snippet Generator by dzhavat 这类插件本身轻量，但部分功能依赖语言服务（如解析 TypeScript 接口生成 snippet）或外部 CLI（如 prettier 格式化选中文本）。离线时它们不会报错，只会静默降级或失效：
- 首次启用插件时，它可能尝试下载
typescript-language-server或调用node执行脚本——若本地没装 Node.js 或网络不通，功能就不可用 - 解决办法不是重装插件，而是在有网机器上完整跑一次：打开 .ts 文件 → 触发一次 snippet 生成 → 确认输出面板（
View → Output，选该插件通道）无spawn ENOENT或Failed to fetch - 然后把整个
~/.vscode/extensions/dzhavat.snippet-generator-*目录拷到内网机，覆盖安装（注意保留node_modules子目录）
手动解压 .vsix 放入 extensions 目录的硬性要求
这是绕过签名校验的最后手段，但 VSCode 加载机制对目录结构极其敏感：
- 解压后顶层文件夹名必须是
publishername.extensionname-version（如ms-python.python-2024.10.1），不能是extension或随便起名 - 该文件夹内必须包含
package.json、extension.js（或dist/extension.js）、以及所有node_modules和二进制文件（out/server、bin/prettier等） - Windows 路径是
%USERPROFILE%\AppData\Roaming\Code\Extensions\，不是.vscode\extensions\（后者是用户级，前者才是全局扩展目录） - 复制完必须彻底退出 VSCode（包括托盘进程），否则缓存不刷新，新插件不会被识别
真正容易被忽略的点：很多插件的 package.json 里写了 "activationEvents"，比如 "onLanguage:python"，这意味着它根本不会出现在扩展列表里，直到你打开第一个 .py 文件——别只盯着「已安装」状态，得真开对应文件类型去触发。
