VSCode连接MariaDB数据库_快速执行SQL语句与导出结果集

必须同时安装并启用SQLTools主体插件和SQLTools MySQL/MariaDB Driver（作者mtxr），缺一则报“No driver installed”；host、port（默认3306）及SSL配置（云环境需显式设置ssl字段）须准确，且每次重启或切换工作区后需手动Connect。

想用VSCode连MariaDB？第一步就卡住的人不在少数。问题往往出在一个看似简单的环节：装完SQLTools主插件后，以为万事大吉，结果连接时直接弹窗提示“No driver installed”。其实，那个SQLTools MySQL/MariaDB Driver可不是什么可选组件，而是硬性依赖，缺了它，连接MariaDB注定失败。

必须同时启用两个扩展：SQLTools + MariaDB 驱动

这里有个关键认知：VSCode本身并不把MariaDB当作一个独立的数据库类型来识别，它被归在MySQL的兼容协议之下。所以，你需要安装的驱动是SQLTools MySQL/MariaDB Driver，而且务必认准作者是mtxr。很多人会犯一个错误：在扩展商店里搜索“MariaDB”，然后安装了一个名字里带“MariaDB”但作者并非mtxr的第三方插件，结果就是连接时要么提示Driver not found，要么在握手阶段就神秘失败。

• 核心主扩展：SQLTools（由mtxr发布）
• 配套驱动：SQLTools MySQL/MariaDB Driver（同样由mtxr发布）
• 启用状态检查：两个扩展都必须在扩展面板里点击“启用”，禁用其中任何一个，都会导致你在侧边栏右键点击连接时，弹出那个令人沮丧的No driver installed提示。

connections.json 里 host 和 port 填错最常导致 ETIMEDOUT

驱动装对了，接下来就是配置连接。连接超时（ETIMEDOUT）十有八九是connections.json文件里的host和port填错了。MariaDB的默认端口是3306，但这个数字经常被人漏写。另一个经典陷阱是host填写：在本地直连时写localhost通常没问题，但一旦进入Docker环境，localhost在容器内解析指向的是容器自己，而不是宿主机的MariaDB服务，这自然就连不上了。

• 本地直连场景：host 建议填写 127.0.0.1（这比localhost更可靠，可以避免某些系统下默认使用Unix socket导致的干扰）。
• Docker容器连宿主机场景：在Windows或macOS上，host 应填 host.docker.internal；在Linux上，则需要填写宿主机的真实IP地址。port 依然是 3306。
• 云服务场景：例如使用DigitalOcean的托管数据库，host 是服务商提供的专属域名，并且通常必须开启SSL（这是下一个要讲的重点）。

SSL 配置不匹配，连接会静默超时

如果说host和port错误会明确报错，那么SSL配置问题则更像一个“沉默的杀手”。MariaDB 10.2及以上版本默认要求SSL连接，而SQLTools的MySQL驱动默认配置却是ssl: false。对于强制要求SSL的云托管服务（比如ScaleGrid、AWS RDS的兼容版本），如果不正确配置，连接就会一直卡在“Connecting…”状态，没有任何明确的错误信息，让人无从下手。

• 标准解决方案：在connections.json文件里，找到对应的连接配置项，添加一个字段："ssl": {"rejectUnauthorized": true}。
• 开发环境特例：如果使用的是自签名证书（常见于内部开发环境），则需要将上述配置改为："ssl": {"rejectUnauthorized": false}。
• 重要提醒：不建议直接删除ssl字段来试图“绕过”这个问题。驱动会按照其内部默认值处理，失败的可能性依然很大。

执行语句和导出结果要注意三件事

好不容易连上了数据库，执行查询和导出数据时也有几个细节容易踩坑。首先，按下Ctrl+Enter执行当前SQL语句前，务必先看一眼VSCode右下角的状态栏，确认它显示的是你刚刚成功连接的那个MariaDB连接名称。如果显示的是其他连接或“Not Connected”，执行就会报no connection found。其次，导出功能只对当前查询结果页面生效，如果你想不分页导出全部数据，需要手动在SQL语句里加上LIMIT来拉取。

• 执行单条语句：将光标放在SELECT语句所在行，按Ctrl+Enter即可。如果选中了多行再执行，则只会运行被选中的部分。
• 导出CSV数据：在查询结果面板的右上角点击Export → CSV。请注意，这个操作仅导出当前结果页的数据（默认每页100行），而不是整个查询结果集。
• 防止界面卡死：查询大表时，一定要在语句中加上LIMIT。SQLTools本身不限制返回行数，一个不加限制的SELECT *语句如果拉取十万行数据，很可能会导致VSCode的UI界面暂时失去响应。

最后，还有一个真正容易被忽略的特性：连接状态并不持久。每次重启VSCode、切换工作区，甚至有时仅仅是关闭再重新打开SQLTools侧边栏面板，现有的数据库连接都会断开。当你看到侧边栏连接名称旁的绿色圆点消失后，就必须手动右键点击连接名，选择Connect来重新连接。是的，它没有自动重连机制，这一点需要时刻牢记。