VSCode连接数据库：SQLTools插件使用教程_行业资讯_武汉市顿尔希信息咨询有限公司

VSCode连接数据库：SQLTools插件使用教程

发布时间：2025-12-31 00:00

发布者：P粉986688829

浏览次数：

SQLTools插件可在VSCode中实现跨平台多数据库可视化管理。需依次安装插件、对应数据库驱动、配置连接信息、建立测试连接，并通过注释绑定连接执行SQL查询。

如果您在 Visual Studio Code 中需要连接并管理数据库，SQLTools 插件提供了一种轻量、跨平台且支持多数据库的可视化操作方式。以下是使用 SQLTools 连接和操作数据库的具体步骤：

本文运行环境：MacBook Air，macOS Sequoia。

SQLTools 是 VSCode 的扩展插件，需先通过扩展市场安装，才能启用数据库连接功能。安装后无需重启编辑器即可使用基础界面。

1、打开 VSCode，点击左侧活动栏中的扩展图标（或按快捷键 Cmd+Shift+X）。

2、在扩展搜索框中输入 SQLTools，找到由 mtxr 发布的官方插件。

3、点击“安装”按钮，等待状态变为“已安装”。

SQLTools 本身不内置数据库驱动，需根据目标数据库类型单独安装配套驱动扩展，否则连接时会提示“Driver not found”。驱动必须与 SQLTools 主体插件同时启用。

1、在扩展面板中搜索 SQLTools PostgreSQL Driver（如使用 PostgreSQL）。

2、或搜索 SQLTools MySQL/MariaDB Driver（如使用 MySQL）。

3、或搜索 SQLTools SQLite Driver（如使用本地 SQLite 文件）。

4、为每种拟连接的数据库分别安装对应驱动，并确保其状态为“已启用”。

连接配置以 JSON 格式保存在工作区或用户设置中，支持明文填写或引用环境变量，敏感字段如密码建议通过环境变量注入。

1、按下 Cmd+Shift+P 打开命令面板，输入并选择 SQLTools: New Connection。

2、在弹出的选择框中，选择已安装的驱动类型（如 PostgreSQL）。

3、依次填写 host、port、database、username；密码字段留空，后续通过环境变量或手动输入补充。

4、按回车确认后，该连接将出现在侧边栏的 SQLTools 面板中，名称默认为数据库名加主机缩写。

连接配置完成后需手动触发连接动作，SQLTools 不自动尝试连接。连接成功后可在面板中展开数据库对象树，查看 schema 和表结构。

1、在侧边栏 SQLTools 面板中，右键刚创建的连接项。

2、选择 Connect，若凭据未保存，此时会弹出密码输入框。

3、输入正确密码后，连接状态图标变为绿色圆点，且可展开显示 public（PostgreSQL）或 schemas（MySQL）等节点。

4、右键任意表名，选择 Select Top 100 Rows，验证查询能力是否正常。

SQLTools 支持在独立 .sql 文件中编写语句，并直接关联已连接的数据库执行，结果以表格或文本形式展示，无需切换到其他客户端工具。

1、新建一个文件，保存为 query.sql，确保文件语言模式设为 SQL（右下角点击切换）。

2、在文件顶部添加注释行：-- @conn=your_connection_name（your_connection_name 替换为步骤三中设置的连接名）。

3、编写标准 SQL 语句，例如 SELECT * FROM users LIMIT 5;。

4、右键编辑器空白处，选择 SQLTools: Run Current Query，结果将在下方输出面板中呈现。