vscode原生不支持postgresql连接，需依赖sqltools扩展或psql命令行工具；安装sqltools后须手动安装postgresql驱动，连接时host推荐127.0.0.1、database必填、密码含特殊字符应使用表单模式；psql嵌入终端更轻量，但需确保libpq已安装且path配置正确；导出csv易失真，关键字段建议用copy导出；所有操作后均需执行select 1验证连通性及环境配置。
VSCode里直接连PostgreSQL行不通
VSCode本身不带数据库客户端功能，Ctrl+Shift+P 搜“connect to database”也找不到原生支持。所谓“连接”，实际是靠扩展间接实现——要么用图形化插件（如 SQLTools），要么用命令行工具（如 psql）配合终端集成。别在设置里瞎找“database connection”选项，那不存在。
SQLTools + PostgreSQL驱动是当前最稳的组合
装完 SQLTools 扩展后，必须额外安装对应驱动，否则新建连接时会报错 Driver not found: postgresql。驱动不是自动附带的，得手动点右下角提示里的“Install Driver”，或去命令面板运行 SQLTools: Install Driver 并选 PostgreSQL。
- 连接配置里
host别写localhost—— macOS / Linux 上推荐用127.0.0.1，避免 IPv6 解析失败导致超时 -
database字段不能为空，哪怕只想连上看看有哪些库，也得填一个已存在的库名（比如postgres） - 密码含特殊字符（如
@、/）时，URL 格式连接会出错，老实用表单模式填，别手写postgresql://user:pass@host/db
psql 命令行嵌入 VSCode 终端更轻量可靠
如果你只是偶尔查数据、跑迁移、不想装一堆插件，直接用 VSCode 内置终端跑 psql 反而更快。前提是本地已装 PostgreSQL 客户端（macOS 用 brew install libpq，Windows 装 pgAdmin 时勾选 Command Line Tools）。
- 确保
psql在终端能直接执行：运行which psql（macOS/Linux）或where psql（Windows），没输出就说明路径没加进PATH - 连接时用
psql -h 127.0.0.1 -U username -d dbname，比图形插件少一层抽象，报错信息也更准（比如password authentication failed就真该去检查 pg_hba.conf） - 想保存连接参数？建个
.psqlrc放家目录，加一行\set QUIET 1或\set PROMPT1 '%n@%m %~%R%# '，不用每次输 \conninfo
SQLTools 的查询结果导出容易丢类型信息
点“Export as CSV”看着方便，但 timestamp with time zone 会被转成本地时区字符串，jsonb 字段可能被扁平化甚至截断。如果后续要拿 Excel 或 Python 处理，导出前务必确认字段是否失真。
- 导出前先执行
SELECT pg_typeof(col_name) FROM table LIMIT 1看真实类型 - 对时间/JSON/数组类字段，优先用
COPY (SELECT ...) TO '/tmp/out.csv' WITH (FORMAT CSV, HEADER)，再从文件读取 - SQLTools 的“Run Current Query”默认不带事务，UPDATE/DELETE 没 WHERE 会直接生效——它不像 DBeaver 那样默认开手动提交
插件和命令行各有适用场景，但共同的坑是：以为连上了就万事大吉，其实连通性、权限、时区、字符集、字段类型这些细节，全得在第一次 SELECT 1 之后继续验证。
