VSCode连接PostgreSQL_在编辑器中直接编写SQL与查看数据表

优先选 SQLTools（作者 mtxr）+ SQLTools PostgreSQL Driver，因其稳定、更新勤、支持导出 CSV/TSV/JSON、可设 resultsLimit=0、有明确连接状态指示，而 PostgreSQL by Chris Kolkman 不支持全量导出和 SSL 强制场景。

想在 VSCode 里直接操作 PostgreSQL 数据库？编辑器本身可没这本事，必须借助扩展来补全能力。但问题来了：要是装错插件或者配错参数，很可能连“Connecting…”这关都过不去，更别提执行 SELECT 查询或者点开表结构查看了。

该装哪个扩展：SQLTools 还是 PostgreSQL by Chris Kolkman？

这里有个明确的建议：优先选择 SQLTools（作者 mtxr）并搭配其专用的 SQLTools PostgreSQL Driver。为什么是它？这套组合拳表现相当稳定，更新也勤快，更重要的是功能齐全——支持将查询结果导出为 CSV、TSV、JSON 格式，能自由调整 resultsLimit 限制，连接状态也有清晰的指示。可别图省事，只在市场里搜“PostgreSQL”就装第一个结果。那个 PostgreSQL by Chris Kolkman 扩展虽然轻量，但短板明显：它不支持导出全部结果（没有 resultsLimit=0 这个选项），也处理不了强制 SSL 连接的场景，比如连接 Supabase 或某些 AWS RDS 实例时就会卡壳。

如果遇到 Protocol error: unrecognized message type 这类报错，十有八九是驱动没装对或者版本不匹配。

• 第一步，确认两个扩展都已安装到位：核心的 SQLTools 和驱动的 SQLTools PostgreSQL Driver。
• 第二步，卸载掉其他所有 PostgreSQL 相关的插件，避免潜在的冲突。
• 第三步，重启 VSCode，确保右下角状态栏出现了数据库的小图标。

连接失败的三大高频原因和对应检查项

遇到 Connection refused 或者 FATAL: password authentication failed 这种错误，先别急着怀疑密码输错了。更可能的原因是下面这三处配置出了岔子：

• 服务根本没跑起来：用 pg_isready 命令检查，如果没返回 accepting connections，那说明 PostgreSQL 服务本身就没运行。常见情况比如 Docker 容器停了，或者在 macOS 上用 brew services stop postgresql 之后忘记重新开启了。
• 主机地址填错了：在 macOS 或 Linux 系统上，建议统一使用 127.0.0.1，而不是 localhost。Windows 系统虽然可以用 localhost，但混用容易导致连接不稳定。
• 权限配置没放行：检查 PostgreSQL 的 pg_hba.conf 文件，确保至少有一行配置类似于 host all all 127.0.0.1/32 md5，允许本地连接。修改后，记得执行 pg_ctl reload 或直接重启数据库服务使配置生效。

在编辑器里查表、写 SQL、看结果的完整链路

连接成功只是第一步。接下来，在侧边栏点开 SQLTools 的图标，展开数据库和表结构，右键选择 SELECT * FROM ... 可以快速生成查询语句，当然也可以手动在 .sql 文件里编写。这里的关键在于操作顺序不能乱：

• 先确认连接状态：务必确保 VSCode 右下角状态栏显示着当前连接的名称（通常是绿色图标）。否则执行 SQL 时会报 No active connection found。
• 选中再执行：写好 SQL 语句后，必须用鼠标选中整段 SQL（或者至少将光标停留在该语句范围内），然后再按快捷键 Ctrl+Alt+R（Windows/Linux）或 Cmd+Alt+R（macOS）执行。
• 正确导出结果：查询结果以表格形式出现后，需要将光标点击到表格的任意一个单元格内，这时右上角的导出按钮（一个向下的箭头加表格图标）才会变成可点击状态。如果点的是旁边的“磁盘”图标，那保存的只是 .sql 文件本身。
• 导出全部数据：默认设置下，SQLTools 只拉取前 100 行数据。如果想导出全部结果，需要进入 VSCode 设置，搜索 sqltools.resultsLimit，并将其值设置为 0。

导出 CSV 时字段含逗号或换行符怎么办

这恐怕是个经典的“坑”：如果 SELECT 查询结果里的某个字段包含了逗号 , 或者换行符 \n，再用默认的 CSV 格式导出，文件结构就会被破坏——用 Excel 打开后，肯定会出现串列、错行的问题。这倒不是工具的 bug，而是 CSV 格式本身的限制。

有个简单的临时解决方案：导出时，在弹窗里选择 tsv 格式（制表符分隔）。因为制表符在常规的业务数据里几乎不会出现，所以它的兼容性远好于 CSV。

导出的文件路径由 sqltools.exportPath 设置控制，默认存在系统的下载目录。如果想固定到一个特定位置，可以填写绝对路径，例如 /Users/you/export，注意路径末尾不要加斜杠。

真正麻烦的，其实是文件权限和字符集问题。如果导出的中文出现乱码，需要检查两个地方：一是 VSCode 当前文件的编码是否设置为 UTF-8；二是确认 PostgreSQL 连接的 client_encoding 也是 utf8（连接成功后，执行 SHOW client_encoding; 即可查看）。如果这两处的编码不一致，导出的 CSV 文件用 Excel 打开必然乱码，而且这种乱码无法通过“另存为”来修复。