在 VSCode 中安装 SQLTools 插件并配置对应数据库驱动,通过图形化向导或 JSON 配置连接本地或远程数据库,新建 .sql 文件后用 Ctrl+Enter 执行语句,结果以表格形式展示在下方。

在 VSCode 中安装插件并直接运行 SQL 查询,核心是装对插件(比如 SQLTools)并配置好数据库连接。不需要额外装独立客户端,但得有数据库服务在本地或远程运行。
安装 SQLTools 插件
这是目前 VSCode 里最主流、支持多数据库(MySQL、PostgreSQL、SQLite、SQL Server 等)的免费插件,自带查询执行、结果表格展示、自动补全等功能。
- 打开 VSCode,点击左侧活动栏的扩展图标(或按 Ctrl+Shift+X)
- 搜索框输入 SQLTools,认准作者是 mtxr 的官方插件(图标是蓝色数据库 + 齿轮)
- 点击“安装”,完成后重启 VSCode(部分版本需要)
- 顺手也安装它的常用驱动,比如 SQLTools MySQL/MariaDB Driver 或 PostgreSQL Driver(根据你用的数据库选)
配置数据库连接
插件装好后,要告诉它连哪台数据库。SQLTools 提供图形化向导,也可以手动编辑 JSON 配置。
- 按 Ctrl+Shift+P 打开命令面板,输入并选择 SQLTools: New Connection
- 选择对应数据库类型(如 MySQL),填入主机、端口、用户名、密码、数据库名
- 勾选“Save connection”保存,连接名会出现在侧边栏的 SQLTools 面板中
- 点击连接名右侧的 ▶️ 图标,即可测试连接是否成功
写 SQL 并直接运行
连接成功后,新建一个 .sql 文件,就可以写查询并一键执行了。
- 新建文件 → 保存为 query.sql(后缀很重要,VSCode 会自动识别语法高亮)
- 输入 SQL,比如 SELECT * FROM users LIMIT 5;
- 光标放在语句内,按 Ctrl+Enter(Windows/Linux)或 Cmd+Enter(Mac)运行当前语句
- 结果会以表格形式显示在下方面板,支持排序、复制整行 / 列、导出为 CSV
- 也可以右键选择“Run Current Statement”或“Run All Statements”
小提示和常见问题
有些细节不注意容易卡住,提前留意能省不少时间:
- 确保数据库服务正在运行(例如 MySQL 的
mysqld进程已启动) - 如果连不上,检查 防火墙、用户权限(MySQL 要授权
host,别只用localhost) - SQLTools 默认不支持 Oracle 或 DB2,需另寻插件或使用通用 ODBC 方案
- 想自动格式化 SQL?可再装插件 SQL Formatter,保存时自动美化
基本上就这些。整个过程不复杂但容易忽略连接测试和驱动匹配,配通一次之后,写查改都挺顺手。