vscode如何连接并操作数据库_使用SQL工具扩展详解【教程】

VS Code需通过sqlTools扩展连接数据库，安装主扩展及对应驱动后，手动配置connections.json文件，连接成功方可执行SQL查询并查看结果。

VS Code 本身不内置数据库连接功能，必须依赖扩展；SQLTools 是目前最稳定、支持最广的方案，比 database Client 或 SQL Server Extensions 更适合多数据库统一管理。

安装 SQLTools 及对应驱动

SQLTools 是一个插件平台，连接不同数据库需要额外安装对应驱动（Driver），不是装完主扩展就自动支持所有数据库。

• 在 VS Code 扩展市场搜索并安装 SQLTools（作者：mtxr）
• 再安装对应数据库驱动，例如：
  • postgresql → 安装 SQLTools PostgreSQL Driver
  • mysql / mariadb → 安装 SQLTools MySQL/MariaDB Driver
  • sqlite → 安装 SQLTools SQLite Driver
  • SQL Server → 安装 SQLTools SQL Server Driver
• 驱动必须与 SQLTools 主体同时启用，缺一不可

配置 connection.json 连接信息

连接数据库靠的是 connections.json 配置文件，不是图形界面填表——手动编辑是常态，路径通常为：~/.sqltools/connections.json（linux/macOS）或 %USERPROFILE%.sqltoolsconnections.json（windows）。

常见错误：复制示例后没改 host、database 或漏掉 port；PostgreSQL 默认端口 5432，MySQL 是 3306，SQL Server 是 1433，不写会连不上。

{   "connections": [     {       "name": "my-postgres",       "driver": "PostgreSQL",       "host": "localhost",       "port": 5432,       "database": "myapp_dev",       "username": "postgres",       "password": "dev123"     }   ] }

执行 SQL 查询与结果查看

连接成功后，在资源管理器侧边栏点击 SQLTools 图标，展开连接列表，右键选择 Connect。连接成功会有状态提示（如 “Connected to my-postgres”）。

• 新建 .sql 文件，写查询语句，光标停在某句上按 Ctrl+Shift+P → 输入 SQLTools: Run Current Statement（或快捷键 Ctrl+Enter）
• 结果以表格形式显示在下方 SQLTools Results 面板，支持导出为 csv
• 注意：如果执行报错 Query failed: no connection found，说明当前没激活连接，需先右键连接名点 Connect，不能只靠配置文件存在就认为已连上
• 对大表慎用 select *，SQLTools 默认不限制返回行数，可能卡死 ui

常见问题与绕过限制

某些场景下 SQLTools 行为不符合直觉，不是 bug，而是设计如此：

• password 不支持环境变量或密钥管理器，明文写在 connections.json 中 —— 生产环境务必避免，建议仅用于本地开发
• 不支持 ssh 隧道直连，若数据库在跳板机后，得先用 ssh -L 做端口转发，再连 localhost
• 没有“自动补全字段名”功能（不像 DBeaver），但支持基础关键字高亮和括号匹配
• 切换连接后，之前打开的 .sql 文件不会自动绑定新连接，需手动右键选择 SQLTools: Set Connection for Current File

真正麻烦的从来不是连上，而是连上之后搞不清当前用的是哪个连接、查的是哪张表、结果有没有被 LIMIT 截断——这些都得靠你主动确认，而不是指望工具提醒。