VSCode连接PostgreSQL需装Microsoft官方扩展（大象图标、发布者为Microsoft），填准host（本地用localhost/云用完整域名）、port（默认5432）、database（具体库名非实例名），密码为空仍需认证，连通前须核对pg_hba.conf与云服务IP/SSL设置。
PostgreSQL 扩展在 VS Code 里不是“装上就能连”，关键卡点往往出在连接配置或权限细节上。直接装 Microsoft 官方的 PostgreSQL 扩展（大象图标）是正确起点，但后续几步不踩坑才能真正连上。
怎么确认装的是官方 PostgreSQL 扩展
VS Code 扩展市场搜 PostgreSQL，结果里认准发布者是 Microsoft，名字叫 PostgreSQL（不是 vscode-postgres 或其他同名第三方）。后者功能弱、更新慢，且不支持 GitHub Copilot Chat 联动和 Azure 集成。
- 安装后侧边栏出现灰色大象图标，不是小象、不是数据库图标变体
- 扩展详情页显示“by Microsoft”，版本号在 0.9.x 以上（2026 年主流是 0.10.x）
- 禁用所有其他 PostgreSQL 类插件，避免命令冲突（比如
Run Query绑定多个插件时右键失效）
连接时必填字段和常见填错项
点击大象图标 → + Add Connection，弹出表单里看似简单，但 host、port、database 这三项最容易输错：
-
host：本地 PostgreSQL 默认是localhost，不是127.0.0.1（某些 pg_hba.conf 配置下不等价）；云服务如 Azure 必须填完整域名，例如myserver.postgres.database.azure.com -
port：默认5432，但 Docker 启动时若映射到其他端口（如5433），这里必须同步改，不能只改命令行里的-p -
database：不是实例名，也不是用户名；是具体要连的那个库名，比如postgres（系统库）、myapp_dev，空着会报database "user" does not exist - 密码留空 ≠ 不验证：如果服务器启用了
md5或scram-sha-256认证，密码为空会直接拒绝，哪怕你本地pg_hba.conf写了trust
连不上时先查这三处日志和提示
扩展本身不弹详细错误，得靠终端输出和 PostgreSQL 服务日志交叉验证：
- VS Code 底部状态栏左下角若显示
Connecting...卡住超过 10 秒，大概率是网络不通或防火墙拦截（尤其是 Windows 防火墙默认拦5432） - 右键执行查询报错
Connection refused：检查 PostgreSQL 服务是否运行（sudo systemctl status postgresql或 Windows 服务管理器） - 报错
password authentication failed for user "xxx"：不是密码输错，而是用户没权限连目标库——用psql -U postgres登进去，执行GRANT CONNECT ON DATABASE mydb TO myuser; - Azure 用户注意：连接字符串里
-U后面的用户名必须带@server-name后缀，扩展 UI 表单里user字段也要填全，例如admin@myserver
连接成功后怎么安全地存密码
扩展不推荐明文存密码在 settings.json 里，但又不想每次输，可用两种方式：
- 用系统密钥链：Windows 上勾选
Use system keychain（设置里搜postgres.useSystemKeychain），Mac/Linux 自动走libsecret或keytar - 用
.pgpass文件：在用户主目录建.pgpass（Windows 是%APPDATA%\postgresql\pgpass.conf），格式为host:port:database:username:password，权限设为600（Linux/macOS） - 别碰
postgres.connections数组里硬编码密码——这是最不安全的写法，尤其当项目进 Git 时会泄露凭据
pg_hba.conf 的认证方式，云环境则紧盯服务端的允许 IP 和 SSL 要求——这些细节不核对，装再新版本的扩展也没用。 
