vscode需安装sqltools及postgresql驱动才能连接postgresql；须确保服务运行、正确配置host/port/database、调整结果限制与导出格式，并检查pg_hba.conf权限规则。
VSCode里没有原生PostgreSQL连接功能
VSCode本身不带数据库客户端，得靠扩展补上这个能力。最常用的是 SQLTools 配合 SQLTools PostgreSQL Driver，它能连、能查、能导出，而且不依赖外部GUI工具。别装错扩展——搜 “SQLTools” 时认准作者是 mtxr，其他同名插件可能只支持MySQL或功能残缺。
常见错误现象：Connection failed: Connection refused，多半是没装驱动，或者PostgreSQL服务根本没在本地跑（比如用Docker但容器没启动，或macOS上用Homebrew安装后忘了执行 brew services start postgresql）。
- 确保 PostgreSQL 已运行：终端执行
pg_isready，返回accepting connections才算就绪 - SQLTools 连接配置里，
host别写localhost—— macOS / Linux 上推荐填127.0.0.1，Windows 可以用localhost，但统一用127.0.0.1更少出问题 -
port默认是5432，改过的话必须填对；database字段不能留空，哪怕只想连上再选库，也得先填个存在的库名（比如postgres）
导出查询结果为CSV必须手动触发，不是右键菜单第一项
SQLTools 执行完查询后，结果页右上角有三个小图标：复制、保存、导出。导出 CSV 的按钮图标是「向下箭头+表格」，不是「磁盘」那个保存按钮。「保存」只会把当前SQL文件存下来，和结果无关。
使用场景：你写了 SELECT * FROM users LIMIT 1000;，执行后看到表格，这时别急着关tab——先把光标点进结果区域（任意单元格），再点导出图标，否则按钮是灰色的。
- 导出前确认结果集已完整加载：如果查询数据量大，SQLTools 默认只拉前 100 行，导出的也是这100行。想导全部，得在设置里改
sqltools.resultsLimit为0（0 = 不限制） - 导出的CSV默认用英文逗号分隔，不含BOM，字段不加引号——如果某字段含换行符或逗号，会破坏CSV结构。真遇到这种数据，建议先导出为TSV（制表符分隔），SQLTools 支持切换格式，在导出弹窗里选
tsv - 路径由系统默认下载目录决定，不会弹窗让你选位置。想改，得提前在 VSCode 设置里搜
sqltools.exportPath，填绝对路径如/Users/you/data
权限不足时连不上，错误信息明确但容易被忽略
典型报错：connection to server at "127.0.0.1", port 5432 failed: FATAL: password authentication failed for user "xxx"。这不是密码输错了，而是 PostgreSQL 的 pg_hba.conf 没放行该用户从本地IP的连接。
使用场景：你用 CREATE USER myuser WITH PASSWORD '123'; 建了用户，但在 psql 里能登，VSCode里登不了——大概率是 pg_hba.conf 里这一行没配：
host all myuser 127.0.0.1/32 md5
改完记得 reload 配置：pg_ctl reload 或 sudo systemctl reload postgresql（取决于你的部署方式）。
- 别直接改
pg_hba.conf里的local行去加trust——虽然能跳过密码，但极不安全，尤其开发机常被共享时 - 如果用 Docker 运行 PostgreSQL，检查是否漏了
-e POSTGRES_PASSWORD=xxx，并且docker run命令里有没有暴露-p 5432:5432 - Windows 用户若用 WSL2，
host得填 WSL2 的 IP（查cat /etc/resolv.conf里的nameserver），而不是localhost
连PostgreSQL不是输对账号密码就完事，pg_hba.conf 的规则、SQLTools 的结果加载策略、导出时的分隔符隐含行为——这三个地方不动手调，十次有八次卡在“明明能连却导不出”或者“导出来打不开”。
