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

适用于 macOS 12+（Monterey / Ventura / Sonoma / Sequoia），支持 Apple Silicon（M1/M2/M3） 和 Intel
推荐使用 Homebrew（最简单、最常用）

---

一、推荐方式：使用 Homebrew 安装（99% 用户选这个）

1. 安装 Homebrew（如果还没装）

打开 终端（Terminal），粘贴运行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装过程会提示输入密码并按回车。

---

2. 安装 PostgreSQL

brew install postgresql

自动安装最新稳定版（如 PostgreSQL 17），并包含：

• psql 命令行工具
• pg_dump、createdb 等
• pgAdmin 可选（后面教你装）

---

3. 启动 PostgreSQL 服务

# 启动服务（当前会话）
brew services start postgresql

# 或手动启动（推荐）
pg_ctl -D /opt/homebrew/var/postgres start   # Apple Silicon
# pg_ctl -D /usr/local/var/postgres start    # Intel 旧版

---

4. 设置开机自启（可选）

brew services start postgresql

以后系统启动时自动运行 PostgreSQL。

---

5. 验证安装成功

psql --version
# 输出类似：psql (PostgreSQL) 17.0

# 进入数据库
psql postgres

在 psql 中运行：

SELECT version();
\l
\q

---

二、其他安装方式（了解即可）

方式	说明	推荐度
Postgres.app	拖拽式 GUI 应用，一键启动	★★★★
官方安装包	.dmg 安装，带 pgAdmin	★★★
Docker	容器化，隔离环境	★★★★

---

三、Postgres.app 方式（适合新手 / 想图形化启动）

1. 下载：https://postgresapp.com
2. 拖到 应用程序 文件夹
3. 双击打开 → 自动初始化并启动
4. 菜单栏有小象图标，可一键启停

默认数据目录：~/Library/Application Support/Postgres/var-17

---

四、图形化管理工具（推荐安装一个）

方式 1：安装 pgAdmin 4（官方 GUI）

brew install --cask pgadmin4

安装后从 Launchpad 打开，添加本地服务器：

• Host: localhost
• Port: 5432
• User: 你的 mac 用户名（Homebrew 版默认）

---

方式 2：DBeaver（免费多数据库 GUI）

brew install --cask dbeaver-community

---

五、Homebrew 版 PostgreSQL 重要路径

路径	说明
/opt/homebrew/var/postgres	数据目录（M1/M2/M3）
/usr/local/var/postgres	数据目录（Intel 旧版）
/opt/homebrew/bin/psql	命令行工具
/opt/homebrew/etc/postgresql@17	配置文件

---

六、设置密码 & 创建用户（推荐）

Homebrew 安装的 PostgreSQL 默认无密码，通过本地 socket 认证。

设置 postgres 角色密码：

psql postgres

ALTER USER postgres WITH PASSWORD 'your_secure_password';
\q

---

创建应用专用用户和数据库

psql 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. 修改监听地址

nano /opt/homebrew/var/postgres/postgresql.conf

找到并修改：

# listen_addresses = 'localhost'
listen_addresses = '*'

---

2. 修改认证方式

nano /opt/homebrew/var/postgres/pg_hba.conf

末尾添加：

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

# 允许所有（仅测试！）
# host    all             all             0.0.0.0/0               md5

---

3. 重启服务

brew services restart postgresql

---

4. 开放 macOS 防火墙（系统设置 → 网络 → 防火墙）

或命令行：

sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /opt/homebrew/bin/postgres

---

八、常用命令总结（终端）

命令	说明
brew services start postgresql	启动服务
brew services stop postgresql	停止服务
brew services restart postgresql	重启
psql postgres	进入数据库
pg_dump mydb > backup.sql	备份
psql mydb < backup.sql	恢复
createdb mydb	创建数据库
dropdb mydb	删除数据库
pg_ctl status	查看状态

---

九、备份与恢复

# 备份
pg_dump -U postgres myapp > myapp_backup.sql

# 恢复
psql -U postgres myapp < myapp_backup.sql
# 或
createdb myapp_restore
psql -U postgres myapp_restore < myapp_backup.sql

---

十、卸载 PostgreSQL（彻底清理）

# 停止服务
brew services stop postgresql

# 卸载
brew uninstall postgresql

# 删除数据（谨慎！）
rm -rf /opt/homebrew/var/postgres
rm -rf /usr/local/var/postgres

# 删除配置文件
rm -rf /opt/homebrew/etc/postgresql@*

---

十一、常见问题（FAQ）

问题	解决方法
psql: error: could not connect to server	brew services start postgresql
FATAL: role "postgres" does not exist	重新初始化：initdb /opt/homebrew/var/postgres
permission denied for database postgres	检查数据目录权限：chmod 700 /opt/homebrew/var/postgres
想换端口	修改 postgresql.conf 中的 port = 5433

---

十二、学习资源

• 官方文档：https://www.postgresql.org/docs/
• Postgres.app：https://postgresapp.com
• Homebrew 公式：https://formulae.brew.sh/formula/postgresql

---

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

---

下一步建议：

1. 安装 DBeaver 或 pgAdmin 图形化管理
2. 用 Python + psycopg2 连接数据库
3. 学习 pg_dump 定期备份

---

需要我提供：

• Python 连接示例？回复 Python
• Docker 版安装？回复 Docker
• 一键备份脚本？回复 备份脚本
• Postgres.app 详细使用？回复 Postgres.app

随时告诉我！