Windows 上安装 PostgreSQL（完整图文教程）

适用于 Windows 10 / 11 / Server 2019+，支持 PostgreSQL 12~17（推荐最新稳定版）

---

一、下载安装包

官方下载地址（推荐）：

https://www.postgresql.org/download/windows

选择 EnterpriseDB 提供的图形化安装器（EDB Installer）：

• 推荐版本：最新稳定版（如 PostgreSQL 17）
• 架构：x86-64（64 位）
• 组件建议：勾选 PostgreSQL Server、pgAdmin 4、Command Line Tools

---

二、安装步骤（图文详解）

1. 运行安装程序

双击下载的 .exe 文件（如 postgresql-17.0-1-windows-x64.exe）

---

2. 欢迎界面 → Next

---

3. 选择安装目录（默认即可）

C:\Program Files\PostgreSQL\17

建议 不要安装在中文路径，避免编码问题。

---

4. 选择组件

组件	是否勾选	说明
PostgreSQL Server	是	数据库核心
pgAdmin 4	是	图形化管理工具（推荐）
Stack Builder	否	可选，后续可运行
Command Line Tools	是	psql、pg_dump 等命令

---

5. 数据目录

默认：

C:\Program Files\PostgreSQL\17\data

可自定义，但避免权限问题（如 D:\pgdata）

---

6. 设置超级用户密码（超级重要！）

密码：your_secure_password123

务必记住！ postgres 用户是默认超级用户。

---

7. 端口号

默认：5432

确保端口未被占用（如旧版 PG、MySQL 等）

---

8. 高级选项 → 默认即可（Locale: [Default locale]）

---

9. 准备安装 → Next → Install

---

10. 完成安装

• 取消勾选“Launch Stack Builder”（除非你要额外驱动）
• 点击 Finish

---

三、验证安装成功

1. 检查服务是否运行

按 Win + R → 输入 services.msc → 找到：

postgresql-x64-17

状态应为 Running

---

2. 使用 psql 命令行测试

打开 命令提示符（CMD） 或 PowerShell：

psql -U postgres

输入密码 → 进入 psql：

postgres=# SELECT version();
postgres=# \l
postgres=# \q

---

3. 打开 pgAdmin 4（图形界面）

桌面或开始菜单找到 pgAdmin 4：

1. 首次启动会要求设置主密码（用于保存连接密码）
2. 右键 Servers → Register → Server
3. 填写：

• Name: Local PostgreSQL
• Host: localhost
• Port: 5432
• Username: postgres
• Password: 你设置的密码

1. 保存 → 双击连接

---

四、环境变量配置（让 psql 全局可用）

默认已自动配置，但可手动检查：

1. 右键 此电脑 → 属性 → 高级系统设置 → 环境变量
2. 在 系统变量 → Path 中应包含：

C:\Program Files\PostgreSQL\17\bin

这样你可以在任意目录运行 psql、pg_dump 等命令。

---

五、创建第一个数据库和用户

方法 1：使用 pgAdmin（推荐新手）

1. 连接后右键 Databases → Create → Database
2. 名称：myapp
3. 右键 Login/Group Roles → 创建用户 appuser

---

方法 2：使用命令行

psql -U postgres

CREATE DATABASE myapp;
CREATE USER appuser WITH ENCRYPTED PASSWORD 'apppass123';
GRANT ALL PRIVILEGES ON DATABASE myapp TO appuser;
\q

测试连接：

psql -h localhost -U appuser -d myapp

---

六、允许远程连接（生产慎用）

1. 修改 postgresql.conf

路径：

C:\Program Files\PostgreSQL\17\data\postgresql.conf

找到并修改：

# listen_addresses = 'localhost'
listen_addresses = '*'

---

2. 修改 pg_hba.conf

路径：

C:\Program Files\PostgreSQL\17\data\pg_hba.conf

在末尾添加：

# 允许局域网访问
host    all             all             192.168.1.0/24          md5

# 允许所有（不推荐，仅测试）
# host    all             all             0.0.0.0/0               md5

---

3. 重启服务

net stop postgresql-x64-17
net start postgresql-x64-17

---

4. 开放 Windows 防火墙

netsh advfirewall firewall add rule name="PostgreSQL 5432" dir=in action=allow protocol=TCP localport=5432

---

七、常用命令（CMD / PowerShell）

命令	说明
psql -U postgres	进入数据库
pg_dump mydb > backup.sql	备份
psql mydb < backup.sql	恢复
createdb mydb	创建数据库
dropdb mydb	删除数据库
pg_ctl status	查看状态

---

八、卸载 PostgreSQL

1. 控制面板 → 程序 → 卸载 PostgreSQL
2. 删除残留目录：

• C:\Program Files\PostgreSQL\17
• C:\Users\你的用户\AppData\Roaming\pgAdmin

1. 删除数据目录（如 D:\pgdata）

---

九、常见问题（FAQ）

问题	解决方法
psql: could not connect to server	检查服务是否启动、端口是否正确
FATAL: password authentication failed	重置密码：ALTER USER postgres WITH PASSWORD 'newpass';
中文乱码	设置客户端编码：SET client_encoding = 'UTF8';
无法远程连接	检查 listen_addresses、防火墙、pg_hba.conf

---

十、学习资源

• 官方文档：https://www.postgresql.org/docs/
• pgAdmin 教程：https://www.pgadmin.org/
• 中文教程：掘金、CSDN、B站搜索 “PostgreSQL Windows”

---

恭喜！你已成功在 Windows 上安装 PostgreSQL！

---

下一步建议：

1. 用 Python + psycopg2 连接数据库
2. 学习 pgAdmin 图形化操作
3. 定期使用 pg_dump 备份

---

需要我提供：

• Python 连接示例？回复 Python
• Docker 版安装？回复 Docker
• 一键备份脚本？回复 备份脚本

随时告诉我！