VSCode连接MariaDB数据库_快速执行SQL语句与导出结果集
必须同时安装并启用SQLTools主体插件和SQLTools MySQL/MariaDB Driver（作者mtxr），缺一则报“No driver installed”；host、port（默认3306）及SSL配置（云环境需显式设置ssl字段）须准确，且每次重启或切换工作区后需手动Connect
必须同时安装并启用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来重新连接。是的，它没有自动重连机制，这一点需要时刻牢记。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
