vscode离线插件安装需严格匹配版本、路径和触发条件：校验engines.vscode字段与本地版本主版本号一致；拖拽前确保vscode已加载工作区且有系统焦点；命令行必须用绝对路径并注册code命令；装后需手动启用并完整触发lsp下载或复制整个扩展目录。
离线安装 VSCode 插件不是“凑合用”，而是有明确兼容边界和操作刚性要求的标准化流程——装不上，99% 是版本错、路径错、或没触发解压动作，不是工具不支持。
怎么确认 .vsix 和当前 VSCode 版本是否匹配
VSCode 启动时会严格校验 package.json 里的 "engines": {"vscode": "^1.85.0"} 字段，只比对主版本号（如 1.90.2 → 取 1.90），不向下兼容。
- 查看本地版本：在 VSCode 中按
Ctrl+Shift+P输入Help: About，记下Version（如1.92.2）和括号内架构（如arm64） - 下载时必须去官方市场页面（如
https://marketplace.visualstudio.com/items?itemName=ms-python.python），点右上角 Download Extension，不要从 GitHub Release 或第三方网盘拿 - 插件名带平台后缀的（如
cpptools-win32.vsix、cpptools-darwin.vsix）不能混用；arm64版 VSCode 装x64版 vsix 会直接报Extension is not compatible with Code
拖拽 .vsix 到编辑区为什么没反应
这是离线部署中最常被误判为“失败”的场景，实际是 GUI 触发条件未满足，而非安装机制失效。
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），纯启动页（Welcome 页面）不响应拖放
- 窗口要有系统焦点：任务栏图标需高亮；多显示器缩放偏移、全屏模式、RDP/TeamViewer 远程桌面都会导致坐标捕获失败
- 拖的是原始未解压的
.vsix文件（可用unzip -l xxx.vsix确认顶层为extension/目录），不是解压后的文件夹，也不是重命名的.zip - 右下角状态栏若显示
Extensions disabled by policy，说明企业组策略已全局禁用扩展，拖拽和 CLI 都会静默失败
code --install-extension 命令总报错或静默失败
该命令对路径和环境极其敏感，不是“执行了就完事”，错误信息基本就是问题本身。
- Windows 下路径含空格或中文，必须用英文双引号包裹：
code --install-extension "C:\my ext\prettier-9.10.3.vsix" - macOS/Linux 必须用绝对路径，
./ext.vsix或~/ext.vsix会失败：code --install-extension /opt/vscode-ext/ms-python.python-2024.6.0.vsix - 提示
command not found: code，说明 CLI 未注册到 PATH —— 在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - 想覆盖旧版，加
--force参数：code --install-extension xxx.vsix --force
插件显示“已安装”但 Python 补全/格式化不生效
这是典型的“假成功”：VSIX 包已注册，但关键运行时组件根本没拉下来，尤其语言类插件首次启用会尝试离线不可达的 LSP 下载。
- 手动启用插件：安装后插件默认处于禁用状态，需在扩展面板点「启用」或重启 VSCode
- 提前在有网机器上完整触发一次：打开一个
.py文件 → 触发补全 → 等状态栏消失、输出面板无Downloading...日志 → 此时插件目录下的dist/和node_modules/已就绪，再打包整个ms-python.python-xxxx目录复制到离线机对应extensions/路径下 - 验证是否真解压：检查
%USERPROFILE%\.vscode\extensions\ms-python.python-2024.6.0\（Windows）是否存在，且内含package.json、dist/、node_modules/—— 如果只有.vsix文件躺在那里，说明安装根本没走完
最易被忽略的一点：插件依赖链。比如 ms-python.python 依赖 ms-python.pylance，离线时必须把两个 .vsix 都下载，并按依赖顺序安装（先 Pylance，再 Python）。漏掉任一环，编辑器不会报错，但补全、类型提示、Go to Definition 全部失效。
