直接拖.vsix到主编辑区是最稳的离线安装方式，需vscode已启动、有焦点、未全屏且未连远程容器；若无反应，先查右下角是否显示“extensions disabled by policy”；装完须手动启用或彻底重启vscode。
直接拖.vsix到编辑区是最稳的安装方式
离线装数据库类插件（比如 bradlc.vscode-tailwindcss、mtxr.sqltools、ms-mssql.mssql）时，别先急着开命令行。只要 VSCode 已启动、窗口有焦点、没全屏、也没连远程开发容器，把下载好的 xxx.vsix 文件直接拖进主编辑区（就是你平时写代码那块白底区域），松手就会弹出确认框——这个动作不发任何网络请求，也不依赖 code 命令是否注册，成功率最高。
如果拖进去没反应，先看右下角状态栏有没有 Extensions disabled by policy 提示：企业组策略可能已全局禁用扩展安装，这时候得找 IT 部门解封或换手动解压方案。
装完插件默认是禁用状态，必须手动点「启用」，或者干脆退出 VSCode（包括托盘进程），再重新打开，否则 SQL 连接面板、查询快捷键这些功能根本不会加载。
下载前必须核对 publisher 和 version
数据库插件对 VSCode 版本和平台敏感度极高。比如 ms-mssql.mssql 的 1.14.0 版要求 VS Code >= 1.85，而内网机器可能还跑着 1.79；又比如 mtxr.sqltools 的 Darwin ARM64 包不能往 Windows 上硬装。
- 务必从官方市场页下载：
https://marketplace.visualstudio.com/items?itemName=ms-mssql.mssql→ 右侧 Resources →Download Extension - 不要用 GitHub Release 页面的包，除非你已比对过
package.json里的engines.vscode字段和 SHA256 值 - 需要批量或下历史版本？拼 API 直链：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-mssql/vsextensions/mssql/1.14.0/vspackage，其中publisher是小数点前半段，extension_name是后半段，version必须和 Version History 里完全一致
code --install-extension 报错 INVALID_SIGNATURE 怎么办
离线环境无法校验微软签名证书链，命令行安装时大概率报 INVALID_SIGNATURE。这不是文件损坏，是安全机制在起作用——必须加 --allow-unverified 参数：
code --install-extension "C:/vsix/mssql-1.14.0.vsix" --allow-unverified
注意三点：
- Windows 下路径含空格或中文会静默失败，必须移到纯英文路径，如
C:/vsix/，且推荐用正斜杠写法 - Linux/macOS 必须用绝对路径：
/opt/vscode-ext/mssql-1.14.0.vsix - 如果提示
command not found: code，不是 PATH 问题，而是 VSCode 没启用 Shell Command：按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行
装完连不上数据库？检查语言服务器和依赖插件
像 ms-mssql.mssql 或 mtxr.sqltools 这类插件，首次启用会尝试下载对应的语言服务器（LSP）二进制，离线时卡在 Downloading... 是常态。这不是安装失败，而是初始化卡住。
解决方法只有两个：
- 提前在能联网的机器上完整启用一次该插件，等 LSP 下载完成，然后把整个
%USERPROFILE%\.vscode\extensions\ms-mssql.mssql-1.14.0\（Windows）目录打包拷过去，覆盖安装 - 手动补全依赖：查
.vsix解压后package.json的extensionDependencies字段，比如ms-mssql.mssql强依赖ms-dotnettools.vscode-dotnet-runtime，漏掉它，连接向导根本打不开
验证是否真可用，别只看扩展面板有没有勾，得打开一个 .sql 文件，看底部状态栏有没有出现数据库连接图标，或者按 Ctrl+Shift+P 能否搜到 SQL: Connect 命令。
