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

如果您在 Visual Studio Code 中需要连接并管理数据库,SQLTools 插件提供了一种轻量、跨平台且支持多数据库的可视化操作方式。以下是使用 SQLTools 连接和操作数据库的具体步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装 SQLTools 插件
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,验证查询能力是否正常。
五、执行 SQL 查询脚本
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,结果将在下方输出面板中呈现。










