PostgreSQL 安装与配置指南（Windows / macOS / Linux）

✅ PostgreSQL 安装与配置指南（Windows / macOS / Linux）

---

🎯 学习目标

在不同操作系统上成功安装 PostgreSQL，了解关键目录和可执行文件，并完成本地安装实践。

---

一、安装 PostgreSQL

---

✅ 1. Windows 系统安装

方法一：使用官方图形安装包（推荐新手）

🔹 步骤：

1. 访问官网下载页面：
   👉 https://www.postgresql.org/download/windows/

2. 下载最新稳定版（如 PostgreSQL 16.x）

3. 双击运行安装程序 → 一路“Next”

4. 设置安装路径（默认 C:\Program Files\PostgreSQL\16）

5. 设置数据目录（默认 C:\Program Files\PostgreSQL\16\data）

6. 设置超级用户（postgres）密码 → 务必记住！

7. 设置端口（默认 5432，一般不改）

8. 选择区域（Locale）→ 建议选 Chinese (Simplified)_China.936 或 English_United States.1252

9. 安装完成 → 勾选“Launch Stack Builder?” → 可跳过

10. 安装程序会自动启动 PostgreSQL 服务

---

✅ 验证安装

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

psql -U postgres

输入密码 → 进入 PostgreSQL 命令行即表示安装成功！

---

✅ 2. macOS 系统安装

方法一：使用 Homebrew（推荐开发者）

🔹 前提： 已安装 Homebrew（https://brew.sh）

# 安装 PostgreSQL
brew install postgresql

# 启动服务（开机自启）
brew services start postgresql

# 或仅本次启动
pg_ctl -D /opt/homebrew/var/postgres start

# 初始化数据库（如果提示未初始化）
initdb -D /opt/homebrew/var/postgres

💡 Apple Silicon (M1/M2) 芯片路径为 /opt/homebrew/...
Intel 芯片路径为 /usr/local/var/postgres

---

方法二：使用官方安装包（图形化）

1. 下载：https://www.postgresql.org/download/macosx/
2. 安装 .dmg 文件 → 拖拽到 Applications
3. 打开“PostgreSQL”应用 → 启动服务器
4. 使用 psql 命令行或 pgAdmin 图形工具连接

---

✅ 验证安装

psql -U $(whoami)  # macOS 默认创建当前用户为数据库用户
# 或
psql postgres

---

✅ 3. Linux 系统安装（Ubuntu / Debian / CentOS）

Ubuntu / Debian（使用 apt）

# 导入官方 GPG 密钥和仓库（推荐最新版）
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -

# 更新包列表
sudo apt update

# 安装 PostgreSQL 和客户端工具
sudo apt install postgresql postgresql-contrib

# 启动并设置开机自启
sudo systemctl start postgresql
sudo systemctl enable postgresql

---

CentOS / RHEL（使用 yum / dnf）

# 安装官方仓库（以 PostgreSQL 16 为例）
sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm

# 安装 PostgreSQL
sudo dnf install -y postgresql16-server postgresql16-contrib

# 初始化数据库
sudo /usr/pgsql-16/bin/postgresql-16-setup initdb

# 启动服务
sudo systemctl start postgresql-16
sudo systemctl enable postgresql-16

---

✅ 验证安装（Linux）

sudo -u postgres psql

默认超级用户是 postgres，无密码（本地信任认证）

---

二、重要目录结构

安装后，PostgreSQL 会生成以下关键目录：

目录类型	Windows 默认路径	macOS (Homebrew)	Linux (Ubuntu)
数据目录	C:\Program Files\PostgreSQL\16\data	/opt/homebrew/var/postgres	/var/lib/postgresql/16/main
配置目录	同上（postgresql.conf, pg_hba.conf）	同数据目录	同数据目录
日志目录	通常在数据目录内 log/	同数据目录	/var/log/postgresql/
二进制目录	C:\Program Files\PostgreSQL\16\bin	/opt/homebrew/bin	/usr/lib/postgresql/16/bin

📌 核心配置文件：

• postgresql.conf：主配置文件（端口、内存、日志等）
• pg_hba.conf：客户端认证配置（谁可以从哪连接、用什么方式）
• pg_ident.conf：用户映射（较少用）

---

三、主要可执行文件介绍

命令	作用说明	常用示例
psql	PostgreSQL 交互式命令行客户端	psql -U postgres -d mydb
pg_ctl	控制数据库服务（启动/停止/重启/状态）	pg_ctl start -D /path/to/data
initdb	初始化新的数据库集群（创建数据目录）	initdb -D /new/data/dir
createdb	创建新数据库	createdb myappdb
dropdb	删除数据库	dropdb myappdb
pg_dump	数据库备份工具	pg_dump mydb > backup.sql
pg_restore	从备份恢复（配合 pg_dump -Fc）	pg_restore -d mydb backup.dump

💡 在 Windows 上，这些命令默认已加入 PATH，可直接在 CMD 使用。
在 Linux/macOS 上，可能需要指定路径或添加到 PATH。

---

四、实践任务：在本地电脑安装 PostgreSQL

✅ 请按以下步骤操作：

1. 选择你的操作系统 → Windows / macOS / Linux
2. 按上述对应方法安装 PostgreSQL
3. 启动服务并验证是否成功进入 psql 命令行
4. 执行简单命令测试：

SELECT version();
\l  -- 列出所有数据库
\q  -- 退出

5. （可选）安装图形化管理工具 pgAdmin：
   👉 https://www.pgadmin.org/download/

---

五、常见问题与解决

❓ 1. psql: command not found

→ 说明 bin 目录未加入系统 PATH。
解决：

• Windows：在“环境变量”中添加 C:\Program Files\PostgreSQL\16\bin
• macOS/Linux：在 ~/.bashrc 或 ~/.zshrc 中添加：

export PATH="/opt/homebrew/bin:$PATH"  # macOS Homebrew
# 或
export PATH="/usr/lib/postgresql/16/bin:$PATH"  # Ubuntu

然后执行：source ~/.bashrc

---

❓ 2. 连接被拒绝 / 认证失败

→ 检查 pg_hba.conf 文件，确保本地连接方式为 trust 或 md5

示例（开发环境）：

# TYPE  DATABASE        USER            ADDRESS         METHOD
local   all             all                                     trust
host    all             all             127.0.0.1/32    md5

修改后重启服务：

sudo systemctl restart postgresql   # Linux
pg_ctl restart -D /path/to/data     # macOS/手动安装

---

❓ 3. 端口 5432 被占用

→ 修改 postgresql.conf 中的 port = 5433，重启服务。

---

✅ 完成标志

当你能在终端成功运行：

psql -U postgres -c "SELECT NOW();"

并看到当前时间输出，即表示安装配置成功！

---

🎁 附加建议

• 学习使用 \? 查看 psql 帮助，\h SELECT 查看 SQL 帮助
• 尝试创建自己的数据库和用户：

CREATE DATABASE myapp;
CREATE USER myuser WITH PASSWORD 'mypassword';
GRANT ALL PRIVILEGES ON DATABASE myapp TO myuser;