离线安装sql插件核心是下载正确.vsix文件并补齐运行时依赖;如ms-mssql.mssql需手动部署sqltoolsservice,oracle插件需本地jdk 11+且java在path中,安装必须加--allow-unverified参数,否则因签名验证失败报invalid_signature。

离线安装 SQL 语句编写辅助插件,核心就两点:下载对的 .vsix 文件 + 补齐运行时依赖。光装上插件但没装配套服务(比如 sqltoolsservice 或 JDK),打开就报 command mssql-connect not found 或直接不显示数据库图标,这种失败最常见。
怎么找真正能用的 SQL 插件离线包
别只搜“SQL”——不同数据库后端需要的插件完全不同,且多数插件有隐式依赖:
-
ms-mssql.mssql(SQL Server)必须配sqltoolsservice,否则首次连接必失败;下载地址在 GitHub Releases 页面,不是 Marketplace -
oracle.sql-developer(Oracle)强依赖本地JDK 11+,且java命令必须在PATH中;插件本身不带 JDK -
bradlc.vscode-tailwindcss这类名字带 SQL 的其实是前端工具,和 SQL 编写无关,纯属关键词误导 - 验证方式:打开插件 Marketplace 页面 → 点右上角“Resources”→ “Repository” → 看
package.json里的engines.vscode和dependencies字段
安装时必须加 --allow-unverified
内网机器默认无法访问微软证书服务器,直接 code --install-extension xxx.vsix 会卡在签名验证,报 INVALID_SIGNATURE 错误:
- 正确命令:
code --install-extension mssql-1.10.1.vsix --allow-unverified - 如果提示
command not found: code,先在 VS Code 里按Ctrl+Shift+P运行Shell Command: Install 'code' command in PATH - Windows 下 PowerShell 可能因执行策略拒绝运行,临时放开:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
装完插件但没反应?查真实加载状态
code --list-extensions 显示已安装 ≠ 插件已生效。很多 SQL 插件启动时动态加载子进程(如 sqltoolsservice 或 Java 后端),失败不会弹窗提示:
- 打开 VS Code →
Ctrl+Shift+P→ 输入Developer: Show Running Extensions - 重点看状态列:如果插件名后面标
not activated或failed,说明依赖缺失或路径错误 - 例如
ms-mssql.mssql要求sqltoolsservice解压到~/.vscode/extensions/ms-mssql.mssql-1.10.1/sqltoolsservice/1.10.0/Windows/(路径随版本变) - 日志入口:
Help → Toggle Developer Tools → Console,过滤关键词error或spawn
最容易被忽略的是:插件市场页面写的“支持 Oracle”不等于支持你手头的 Oracle 版本,也不保证兼容你本地的 JDK 小版本。装之前务必核对 engines.vscode、dependencies 和目标环境的 java -version 输出。离线环境下,少一次重试,就是少半天排查时间。











