PostgreSQL Field Guide

macOS 安装 PostgreSQL 18

比较 Homebrew、Postgres.app 和图形安装器并验证本机 PostgreSQL 服务

PostgreSQL macOS 下载页列出三条常用路径:EDB 图形安装器、Postgres.app 和 Homebrew。不要同时让多套服务监听 5432;先选择一种并记录数据目录。

Homebrew

brew update
brew install postgresql@18
brew services start postgresql@18
"$(brew --prefix postgresql@18)/bin/psql" --version

Homebrew 可能不自动把带版本后缀的客户端放入默认 PATH。需要长期使用时,按 brew info postgresql@18 给出的路径配置 shell,而不是复制一个可能随升级改变的 Cellar 路径。

验证连接:

"$(brew --prefix postgresql@18)/bin/psql" -X -d postgres \
  -c "select version(), current_setting('data_directory');"

若本地角色/数据库名不同,用 -U-d 明确指定。

Postgres.app 或图形安装器

  • Postgres.app 适合希望通过菜单栏启动/停止、减少系统配置的本地开发。
  • EDB 安装器包含服务端、pgAdmin 和 StackBuilder,适合需要图形化安装流程的用户。

安装完成后不要只看图标,应使用安装目录中的 psql 执行:

SELECT version(), current_database(), current_user;

Apple Silicon 与 Intel

确认下载包或 Homebrew 前缀对应 arm64/amd64。不要从另一架构复制数据目录;跨环境迁移优先使用逻辑备份或经过验证的升级流程。

多版本诊断

which -a psql
psql --version
lsof -nP -iTCP:5432 -sTCP:LISTEN

psql 客户端版本与服务端不同,不必立即重装;先确认实际连接目标。通常使用不旧于服务端的客户端更稳妥。

Last updated on

On this page