macOS上PostgreSQL安装与配置的终极指南：从新手到专家

最新推荐文章于 2026-06-23 13:44:44 发布

原创

最新推荐文章于 2026-06-23 13:44:44 发布 · 923 阅读

标签

#macOS #PostgreSQL #Homebrew #数据库配置

如果你正在寻找一个功能强大、可靠性高的开源关系型数据库，PostgreSQL绝对是个不错的选择。它支持SQL标准，提供了丰富的功能特性，包括复杂查询、外键、触发器、视图、事务完整性等。在macOS上安装PostgreSQL有多种方式，每种方式都有其特点和适用场景。

PostgreSQL在开发者社区中广受欢迎，特别是在需要处理复杂数据结构和需要高度定制化的场景下表现尤为出色。它支持JSON数据类型，可以轻松处理半结构化数据，同时还提供了强大的全文搜索功能。对于开发者来说，PostgreSQL的扩展性非常好，你可以通过安装各种扩展来增强其功能。

在macOS上，我们有几种主要的安装方式：EDB提供的图形化安装工具、Postgres.app、Homebrew和MacPorts。每种方式都有其优缺点，适合不同需求的用户。接下来，我们将详细介绍每种安装方法的具体步骤和注意事项。

EDB(EnterpriseDB)提供的PostgreSQL安装工具是最官方、最全面的安装方式之一。这个安装包不仅包含了PostgreSQL服务器本身，还附带了pgAdmin管理工具和StackBuilder扩展管理工具。

首先，访问EDB的官方网站下载页面。你会看到不同版本的PostgreSQL可供选择。建议选择最新的稳定版本，除非你有特殊需求需要使用特定版本。下载完成后，你会得到一个.dmg文件。

双击这个.dmg文件，你会看到安装向导界面。按照提示一步步操作即可。安装过程中，系统可能会提示你"这个应用来自未知开发者"，这是因为EDB的安装包没有经过苹果的公证。你可以通过右键点击安装包，选择"打开"来绕过这个限制。

安装过程中有几个关键配置需要注意：

安装完成后，你可以在应用程序文件夹中找到pgAdmin，这是一个图形化的数据库管理工具。首次打开pgAdmin时，它会提示你设置主密码，这个密码用于保护你的pgAdmin配置。

打开终端，输入以下命令验证PostgreSQL是否安装成功：

psql --version

如果安装成功，会显示PostgreSQL的版本信息。然后尝试连接到数据库：

psql -U postgres

系统会提示你输入密码，输入安装时设置的postgres用户密码即可。如果成功连接，你会看到psql的命令行提示符，表示安装配置成功。

Postgres.app是一个专为macOS设计的PostgreSQL发行版，它的最大特点是简单易用。它把PostgreSQL打包成一个标准的Mac应用，无需复杂的配置，双击即可运行。

从Postgres.app官网下载最新版本，下载完成后直接将应用拖到Applications文件夹。首次运行时，点击"Initialize"按钮初始化一个新的PostgreSQL集群。这个过程会自动创建默认数据库和用户。

Postgres.app的一个优点是它内置了许多常用的扩展，如PostGIS(地理信息系统扩展)和pgvector(向量搜索扩展)，这对于需要这些功能的用户来说非常方便。

为了能在终端中使用PostgreSQL的命令行工具，需要将Postgres.app的bin目录添加到PATH环境变量中。打开终端，执行以下命令：

sudo mkdir -p /etc/paths.d && \
echo /Applications/Postgres.app/Contents/Versions/latest/bin | sudo tee /etc/paths.d/postgresapp

然后重启终端，或者执行以下命令使更改立即生效：

source ~/.zshrc  # 如果你使用zsh
# 或者
source ~/.bash_profile  # 如果你使用bash

Postgres.app运行时会自动启动PostgreSQL服务，关闭应用时服务会自动停止。这种方式非常适合开发环境使用，因为你可以随时启动和停止数据库服务，不会占用系统资源。

在Postgres.app的界面中，你可以看到当前运行的数据库实例信息，包括端口号(默认5432)和可用的数据库。它还提供了一个简单的界面来创建新数据库和管理用户。

Homebrew是macOS上最受欢迎的包管理器之一，通过它可以轻松安装和管理各种开发工具，包括PostgreSQL。

首先确保你已经安装了Homebrew，然后在终端中执行以下命令安装PostgreSQL：

brew install postgresql@16

这里的@16表示安装PostgreSQL 16版本，你可以根据需要选择其他版本。安装完成后，Homebrew会显示一些后续操作提示，建议仔细阅读。

PostgreSQL安装完成后，需要手动启动服务：

brew services start postgresql@16

这个命令会将PostgreSQL设置为开机自启动。如果你想手动控制服务的启停，可以使用以下命令：

# 启动服务
pg_ctl -D /opt/homebrew/var/postgresql@16 start
# 停止服务
pg_ctl -D