postgresql 安装macos详细步骤教程
一款易于使用的图形化 PostgreSQL 数据库开发工具。从编写简单的 SQL 查询到开发复杂的数据库,Navicat for PostgreSQL 都能迎合大部份用户的需要,包括 PostgreSQL 初学者以及经验丰富的开发人员。它能连接任何本地或远程 PostgreSQL 服务器,并支持 Amazon
详解在 macOS 上使用 Homebrew 安装 PostgreSQL 的步骤,包括服务启动、psql 命令行测试以及使用 Navicat for PostgreSQL 进行图形化连接的方法,适合 Mac 开发环境快速搭建。
在 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 的管理目录下,请勿手动删除该目录,以免丢失数据。

































