PostgreSQL 安装与配置全指南（适用于 Windows、macOS 与主流 Linux 发行版）
PostgreSQL 是一个功能强大、开源、稳定的对象关系数据库系统，广泛用于后端开发、数据处理与分布式架构中。本指南将手把手教你如何在 Windows、macOS 以及主流 Linux 发行版 上安装 PostgreSQL，并附上安装验证命令与基础配置方法。
一、Windows 安装与配置 PostgreSQL
1. 安装步骤
-
打开官网下载页面：https://www.postgresql.org/download/windows/
-
点击 “Download the installer”，跳转至 EnterpriseDB。
-
下载适用于你的版本（例如 PostgreSQL 16）的安装程序。
-
双击运行，按提示操作：
- 选择安装目录（默认即可）
- 设置数据库超级用户密码（务必记住）
- 设置端口号（默认 5432）
- 默认选择 UTF-8 编码和英文区域设置
2. 验证安装是否成功
打开命令提示符（CMD）或 PowerShell，输入以下命令：
"C:\Program Files\PostgreSQL\16\bin\psql" --version
如果显示如下类似输出，则表示安装成功：
psql (PostgreSQL) 16.1
可选：将
C:\Program Files\PostgreSQL\16\bin添加到系统环境变量PATH，便可直接使用psql命令。
二、macOS 安装与配置 PostgreSQL
方法一：使用 Homebrew 安装（推荐）
- 确保安装了 Homebrew：https://brew.sh/
- 执行以下命令安装 PostgreSQL：
brew update
brew install postgresql
验证安装是否成功：
psql --version
输出示例：
psql (PostgreSQL) 16.1
启动服务：
brew services start postgresql
方法二：使用 Postgres.app（图形界面安装）
- 前往：https://postgresapp.com/
- 下载并安装后，打开应用即可自动初始化服务。
验证安装是否成功：
/Applications/Postgres.app/Contents/Versions/latest/bin/psql --version
可将其加入 PATH：
echo 'export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/latest/bin' >> ~/.zshrc
source ~/.zshrc
之后可使用：
psql --version
三、Linux 安装与配置 PostgreSQL（涵盖主流发行版）
以下为不同发行版的详细安装步骤，均包含启动服务及验证命令。
1. Ubuntu / Debian / Linux Mint / Kali 等
sudo apt update
sudo apt install postgresql postgresql-contrib
验证安装：
psql --version
启动 PostgreSQL：
sudo systemctl start postgresql
sudo systemctl enable postgresql
2. CentOS / Rocky / AlmaLinux / RHEL 系列
添加官方仓库并安装 PostgreSQL 16：
sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm
sudo dnf -qy module disable postgresql
sudo dnf install -y postgresql16-server postgresql16
初始化数据库并启动服务：
sudo /usr/pgsql-16/bin/postgresql-16-setup initdb
sudo systemctl enable --now postgresql-16
验证安装：
/usr/pgsql-16/bin/psql --version
可加入 PATH：
echo 'export PATH=$PATH:/usr/pgsql-16/bin' >> ~/.bashrc
source ~/.bashrc
3. Fedora
sudo dnf install -y postgresql-server postgresql-contrib
初始化数据库：
sudo postgresql-setup --initdb
启动服务：
sudo systemctl enable --now postgresql
验证安装：
psql --version
4. Arch Linux / Manjaro
sudo pacman -Syu postgresql
初始化数据库：
sudo -iu postgres
initdb --locale $LANG -D /var/lib/postgres/data
exit
启动服务：
sudo systemctl enable --now postgresql
验证安装：
psql --version
5. openSUSE / SUSE Linux Enterprise
sudo zypper refresh
sudo zypper install postgresql16-server
初始化数据库（如未自动执行）：
sudo -u postgres initdb
启动服务：
sudo systemctl enable --now postgresql
验证安装：
psql --version
四、PostgreSQL 安装后通用配置
1. 登录数据库
切换至 postgres 用户：
sudo -i -u postgres
psql
退出：
\q
2. 创建用户和数据库
CREATE USER myuser WITH PASSWORD 'mypassword';
CREATE DATABASE mydb OWNER myuser;
五、远程连接配置（可选）
适用于服务器部署环境。
1. 修改 postgresql.conf
路径依据系统不同：
- Ubuntu/Debian:
/etc/postgresql/16/main/postgresql.conf - CentOS/Fedora/RHEL:
/var/lib/pgsql/16/data/postgresql.conf
将：
# listen_addresses = 'localhost'
修改为：
listen_addresses = '*'
2. 修改 pg_hba.conf
添加以下内容以允许远程访问：
host all all 0.0.0.0/0 md5
3. 重启服务：
sudo systemctl restart postgresql
六、常见问题排查
| 问题 | 解决方法 |
|---|---|
psql: command not found |
检查是否将 PostgreSQL bin 路径添加至 PATH |
| 连接被拒绝 | 确保 PostgreSQL 已启动并监听地址正确 |
| 密码验证失败 | 检查 pg_hba.conf 中是否启用了 md5 认证模式 |
七、图形化管理工具推荐
-
pgAdmin（官方推荐 GUI 工具）
https://www.pgadmin.org/download/ -
DBeaver（支持多数据库）
https://dbeaver.io/