SQLTools 是 VSCode 中轻量高效、兼容性强的数据库管理插件，支持 PostgreSQL、MySQL、SQLite 等主流数据库，提供查询执行、自动补全、结果可视化及多环境切换等功能。
在 VSCode 中直接管理数据库，SQLTools 是目前最轻量、兼容性最好、体验最接近专业客户端的插件之一。它不依赖外部 GUI 工具，支持主流数据库（PostgreSQL、MySQL、SQLite、SQL Server、Oracle 等），还能配合 VSCode 原生功能实现查询、自动补全、结果可视化和简单建模。
安装与基础配置
打开 VSCode 扩展市场（Ctrl+Shift+X），搜索 SQLTools，安装官方插件（作者是 mtxr）。安装后重启 VSCode 即可生效。首次使用需手动添加数据库连接：
- 按 Ctrl+Shift+P 打开命令面板，输入 SQLTools: Add Connection
- 选择数据库类型（如 PostgreSQL）、填写主机、端口、数据库名、用户名、密码
- 连接名建议用项目相关命名（如 myapp-prod-db），方便多环境区分
- 勾选 Save Password 可存密（本地加密），也可留空每次手动输入
执行查询与查看结果
新建一个 .sql 文件，写好语句（如 SELECT * FROM users LIMIT 10;），右键选择 SQLTools: Run Current Query，或快捷键 Ctrl+Alt+X。结果以表格形式展示在下方面板，支持排序、复制整行/列、导出为 CSV/JSON。
- 多语句用分号隔开，SQLTools 默认只执行光标所在语句块（从上一个分号/开头到下一个分号）
- 结果表支持双击单元格编辑（仅限 SQLite 和部分支持的驱动），修改后可点击 Save Changes
- 按 Ctrl+K Ctrl+U 可快速格式化 SQL，提升可读性
智能提示与语法支持
启用后，输入 SELECT * FROM 会自动列出当前数据库下的所有表；输入表名后加点（users.），立刻提示字段名。该功能依赖连接成功且元数据加载完成。
- 首次连接后可能需等待几秒加载 schema，期间提示可能延迟或不出现
- 右键连接 → Refresh Metadata 可手动更新表/视图/列信息（适合结构频繁变更的开发环境）
- 若提示失效，检查是否启用了对应驱动（如 MySQL 需额外安装 SQLTools MySQL/MariaDB Driver）
进阶技巧：多环境切换与脚本管理
项目常有 dev/test/prod 多套数据库。SQLTools 支持保存多个连接，并通过状态栏快速切换。点击右下角数据库图标，即可一键切换上下文，所有后续查询自动路由到目标库。
- 把常用 SQL 脚本（如初始化表、测试数据插入）保存为
setup.sql或seed.sql，直接右键运行 - 结合 VSCode 的 Multi-root Workspace，可在同一窗口管理多个项目的数据库连接
- 启用 SQLTools: Enable Logging（命令面板中开启），排查连接失败或查询异常时更直观
基本上就这些。SQLTools 不复杂但容易忽略细节——比如驱动没装全、metadata 没刷新、或者误以为它能替代完整 ORM 调试。把它当作「终端 + 图形化结果」的增强版 SQL 控制台，定位清晰，效率立现。
