postgresql 安装macos详细步骤教程

在 macOS 上搭建 PostgreSQL 开发环境，核心在于分清“数据库服务”与“管理工具”。PostgreSQL 是负责存储数据、处理查询的后端服务，而 Navicat for PostgreSQL 等软件只是用于连接和管理它的图形化客户端。只有先确保数据库服务在后台正常运行，客户端才能成功连接。本教程以 Homebrew 包管理器为主线，演示从安装到验证的全过程，帮助你在 Mac 上快速建立可用的本地数据库环境。

PostgreSQL 服务启动并通过 Navicat 连接成功的界面示意

1. 确认 Mac 环境和安装方式

打开“终端”应用，首先确认你的 Mac 已准备好运行命令行工具。PostgreSQL 在 macOS 上主要有两种安装途径：使用 Homebrew 包管理器或下载官方独立安装包。Homebrew 的优势在于后续的版本升级和服务管理（如开机自启）非常便捷，且能自动处理依赖关系；独立安装包则拥有独立的数据目录和启动脚本。

在终端输入以下命令检查 Homebrew 是否已安装：

brew --version

如果返回版本号，说明环境就绪。若提示“command not found”，需先访问 Homebrew 官网完成安装。此外，建议确认当前 Mac 的芯片架构（Apple Silicon 或 Intel），虽然 Homebrew 会自动适配，但在涉及某些特定扩展库时，架构信息有助于排查兼容性问题。本文后续操作均基于 Homebrew 安装方式，若你选择独立安装包，请参考其自带的向导说明，切勿混用两种方式的命令。

1. 确认 Mac 环境和安装方式

2. 安装 PostgreSQL 并检查命令

确保 Homebrew 索引最新，然后执行安装命令：

brew update
brew install postgresql

安装过程可能需要几分钟，取决于网络速度。安装完成后，验证命令行客户端 psql 是否可用：

psql --version

终端应输出类似 psql (PostgreSQL) 16.x 的版本信息。这表明 PostgreSQL 的二进制文件已成功加入系统 PATH。请注意，如果你的项目中指定了特定的 PostgreSQL 大版本（如 14 或 15），可以在安装时指定公式名称，例如 brew install postgresql@14。不同大版本的数据格式不兼容，若机器上已存在旧版本，请先评估迁移成本，避免直接覆盖导致原有数据不可用。

2. 安装 PostgreSQL 并检查命令

3. 初始化并启动数据库服务

安装结束后，PostgreSQL 并不会自动在后台运行。使用 Homebrew 的服务管理功能将其注册为后台守护进程：

brew services start postgresql

执行后，终端会提示服务已成功启动。为了确认状态，可以列出所有 Homebrew 管理的服务：

brew services list

找到 postgresql 一行，状态应显示为绿色的 started。如果显示 error 或 stopped，请检查终端输出的错误日志，常见原因包括端口 5432 被占用或权限问题。

另一种轻量级的验证方式是使用 PostgreSQL 自带的连接检查工具：

pg_isready

若返回 accepting connections，说明数据库服务已监听默认端口并准备接受请求。这一步至关重要，因为很多新手在安装后直接尝试连接客户端，却因服务未启动而失败。

4. 使用 psql 创建连接测试

在依赖图形界面之前，先用原生命令行工具 psql 验证数据库的可访问性。首次安装后，PostgreSQL 通常会创建一个与当前 macOS 用户名相同的默认超级用户角色，并建立一个同名数据库。

在终端直接输入：

psql postgres

如果成功进入交互界面，提示符会变为 postgres=#。此时执行一条简单的 SQL 查询来确认数据库内核工作正常：

SELECT version();

屏幕将打印详细的 PostgreSQL 版本及编译信息。确认无误后，输入 \q 退出交互模式。

若需要连接特定的业务数据库或用户，可以使用标准连接参数：

psql -h 127.0.0.1 -p 5432 -U 用户名 -d 数据库名

注意，-h 127.0.0.1 强制使用 TCP/IP 连接，这更接近客户端软件的连接行为，有助于提前发现认证配置问题。如果连接被拒绝，请再次确认服务状态及 pg_hba.conf 中的认证规则。

4. 使用 psql 创建连接测试

5. 用客户端连接和管理

当命令行验证通过后，即可使用 Navicat for PostgreSQL 等图形化工具进行可视化管理。打开 Navicat，点击“连接”按钮，选择“PostgreSQL”。

在 Navicat 中填写 PostgreSQL 连接参数

在连接设置窗口中，填写以下关键信息：

• 主机：填写 127.0.0.1 或 localhost。本机开发通常使用此地址。
• 端口：默认为 5432，除非你在配置文件中修改过。
• 初始数据库：填写你要连接的数据库名，如 postgres 或你新建的业务库。
• 用户名/密码：输入具有相应权限的数据库角色名称和密码。注意，这里的密码是数据库用户的密码，而非 macOS 系统密码。

点击“测试连接”按钮。如果弹出“连接成功”提示，说明配置正确。此时可保存连接并双击打开，你将看到左侧的数据库对象树，包括表、视图和函数等。

需要强调的是，Navicat 只是客户端，它不能替代 PostgreSQL 服务。如果关闭了后台的 PostgreSQL 服务，Navicat 将无法连接。对于远程服务器连接，还需配置服务器的监听地址（listen_addresses）和防火墙规则，切勿在生产环境中随意开放公网访问权限。

完成上述步骤后，你的 macOS 本地 PostgreSQL 环境即搭建完毕。日常开发中，可通过 brew services stop postgresql 暂停服务以节省资源，或在项目需要时随时启动。数据文件默认存储在 Homebrew 的管理目录下，请勿手动删除该目录，以免丢失数据。