拖拽.vsix到编辑区是最稳的安装方式；VSCode已启动、窗口有焦点、没全屏、没连远程开发时，把未解压的.vsix文件直接拖进主编辑区，松手即弹出安装确认框，不触发网络请求、不依赖CLI、不校验证书链。
拖拽.vsix到编辑区是最稳的安装方式
VSCode已启动、窗口有焦点、没全屏、没连远程开发时，把未解压的.vsix文件直接拖进主编辑区（不是侧边栏、不是设置页），松手就会弹出安装确认框——这是唯一不触发网络请求、不依赖CLI、也不校验证书链的方式。
常见失败现象：拖进去没反应。先看右下角状态栏是否显示Extensions disabled by policy，这是企业组策略禁用了扩展安装；再检查VSCode是否真的在前台有焦点，远程连接或全屏状态下会静默忽略拖拽。
装完插件默认是禁用状态，必须手动点「启用」，或彻底退出VSCode（包括托盘进程）再重启，否则不会加载。
code --install-extension必须加--allow-unverified参数
离线环境无法校验微软签名证书链，code --install-extension python.vsix 会直接报 INVALID_SIGNATURE 并退出，不加参数就是白跑。
-
code --install-extension python.vsix --allow-unverified是必须项，不能省 - Windows下路径含空格或中文会静默失败，务必用纯英文路径，如
C:/vsix/python.vsix，且推荐用正斜杠 - Linux/macOS必须用绝对路径：
code --install-extension /home/user/ext/python.vsix --allow-unverified - 提示
command not found: code？不是PATH问题，而是VSCode从未注册CLI：按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行
语言类插件首次启用会卡在“Downloading…”
像ms-python.python、volarjs.volar这类插件，.vsix只是前端壳，真正干活的pyright-server、volar-server等LSP二进制服务，是在首次打开.py或.vue文件时才联网下载的。
离线环境下，状态栏一直显示Downloading...，插件看似装上了却没功能——这不是安装失败，而是LSP没落地。
正确做法：
- 在能联网的机器上，完整触发一次：打开一个对应后缀的文件 → 等状态栏显示
Ready→ 关闭VSCode - 整目录拷贝：
~/.vscode/extensions/ms-python.python-2026.6.123456/（含node_modules和out下的native二进制） - 粘贴到内网机相同路径下，然后彻底退出VSCode（包括托盘进程），再打开
VSCode主版本号与插件engines.vscode必须严格匹配
插件package.json里的engines.vscode字段（如^1.92.0）不是建议值，而是硬性准入门槛。VSCode 1.91装^1.92.0的插件，会直接拒绝加载，扩展面板里可能显示“已安装”但实际不可用。
最容易被忽略的一点：VSCode稳定版每月一更，而很多插件的engines.vscode只适配最新1–2个主版本。你从GitHub Release页面随便下载的.vsix，很可能对应的是半年前的VSCode版本，engines.vscode字段早已过期。
所以下载前务必确认三件事：
- 目标机VSCode版本：
code --version输出的第一段数字（如1.92.2→ 主版本是1.92） - 插件Version History里对应版本的
engines.vscode值（不是GitHub页面写的！） - 下载源必须是官方市场页的
Download Extension按钮，或API拼出的直链：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage
