离线安装 vscode 数据库扩展的核心是用 code --install-extension 命令加载本地 .vsix 文件。需提前在有网机器下载对应扩展的 .vsix（如 ms-mssql），注意版本兼容性；安装后还需手动配置依赖服务路径（如 sqltoolsservicepath）并启用子功能（如 database-client.mysql.enabled）。
离线安装 VSCode 数据库管理扩展，核心就一条：用 code --install-extension 命令加载本地 .vsix 文件，不能依赖市场联网下载。只要拿到对应扩展的正确版本文件，就能绕过网络限制完成安装。
怎么获取数据库扩展的 .vsix 文件
离线环境里没有 Marketplace，所以必须提前在有网机器上下载好 .vsix 文件：
- 打开 VSCode 官方扩展页面（如
https://marketplace.visualstudio.com/items?itemName=ms-mssql），找「Download Extension」按钮（部分扩展页会显示） - 更可靠的方式是用第三方工具
vsce或在线 vsix 下载器（如open-vsx.org），输入扩展 ID（例如ms-mssql、cweijan.vscode-mysql、cptx032.database-client）下载对应版本 - 注意版本兼容性：VSCode 1.85+ 要求扩展使用新版 manifest 格式，老版本
.vsix可能报Extension is not compatible with Code - Database Client 这类多数据库支持插件，其
.vsix是单体包，但内部子功能（如 PostgreSQL 支持）不一定默认启用，装完仍需在设置里手动开启database-client.postgresql.enabled
用命令行静默安装 .vsix
把下载好的文件拷到目标机器后，终端执行安装命令即可，无需打开 VSCode GUI：
- 确保已安装 VSCode 并加入系统 PATH（Windows 下可直接用
code，macOS/Linux 需先运行Shell Command: Install 'code' command in PATH） - 执行：
code --install-extension ./path/to/ms-mssql-1.19.4.vsix --force（--force覆盖已存在同名扩展） - 多个扩展可写成循环脚本：
for f in *.vsix; do code --install-extension "$f" --force; done - 不加
--force时，若扩展已存在且版本相同，命令会静默跳过；版本不同则提示冲突，必须加--force才覆盖
装完之后连接不生效？检查三件事
离线装完只是把代码放进去，不代表功能自动就绪：
-
ms-mssql扩展依赖后台SQL Tools Service进程，首次启动会自动拉取二进制（但离线环境下拉不到）——此时需手动下载对应平台的sqltoolsserviceZIP 包（GitHub releases 页面搜microsoft/sqltoolsservice），解压后在 VSCode 设置中指定路径：mssql.sqlToolsServicePath -
Database Client的 MySQL/PostgreSQL 子模块默认关闭，必须进设置搜索database-client.mysql.enabled并勾选，否则添加连接时看不到对应数据库类型选项 - 所有扩展都不读取系统环境变量或
.env，密码、host 等参数必须明文填入连接配置，离线环境也无法调用密钥管理服务（如 Windows Credential Manager），敏感信息只能靠人工核对
真正麻烦的不是安装本身，而是扩展背后依赖的二进制服务（如 SQL Tools Service）和子功能开关——这两项离线时不会自动触发，也几乎不报明确错误，容易卡在“图标有了、连不上、查不出原因”的状态。
