PostgreSQL Field Guide

Windows 安装 PostgreSQL 18

使用 PostgreSQL 官方推荐的 Windows 安装入口配置服务、端口和 psql

PostgreSQL 项目在 Windows 下载页链接 EDB 认证的交互式安装器。安装包通常包含 PostgreSQL 服务端、pgAdmin 和 StackBuilder。

安装时记录

  • major 版本与安装目录;
  • 数据目录,避免放在会被同步软件接管的位置;
  • PostgreSQL 服务账号;
  • 监听端口,默认通常为 5432;
  • postgres 管理角色密码——由密码管理器保存;
  • locale,生产迁移前要验证 collation 行为。

只勾选真正需要的组件。StackBuilder 中的附加驱动和扩展不是 PostgreSQL 核心,按项目需求安装。

用 psql 验证

打开安装器提供的 SQL Shell,或把 PostgreSQL bin 目录加入当前终端路径:

psql.exe --version
psql.exe -X -h localhost -p 5432 -U postgres -d postgres `
  -c "select version(), current_database(), current_user;"

通过“服务”管理器或 PowerShell 查看服务状态:

Get-Service *postgres*

若客户端找不到,先定位安装目录中的 psql.exe,不要下载来源不明的单独 DLL。

常见连接失败

现象先检查
connection refusedPostgreSQL 服务是否运行、端口是否正确
password authentication failed用户名、目标实例、密码和 pg_hba.conf 规则
database does not exist-d 指定的 database 是否创建
连接到意外版本Windows 上是否运行了多个 PostgreSQL 服务

本机开发通常不需要开放入站防火墙。远程访问必须限定来源地址并启用适当 TLS 校验;不要把 pg_hba.conf 设为无密码 trust 来绕过诊断。

卸载前

安装器卸载和删除数据目录是两件事。先用 pg_dump/pg_dumpall --globals-only 导出需要保留的内容并验证恢复,再确认具体数据目录;不要根据文件夹名称猜测后直接删除。

Last updated on

On this page