homebrew 是 macos 安装 postgresql 最稳省心的方式，自动处理依赖、配置服务与默认参数；需先安装 homebrew，再 brew install postgresql，initdb 初始化数据目录，brew services start 启动并设开机自启，psql 默认免密登录，pg_isready 验证服务状态。
直接用 homebrew 安装 postgresql 是 macos 上最稳、最省心的方式。它自动处理依赖、生成服务配置、设好默认参数，装完基本就能用，不用手动改路径或调权限。
安装前确认 Homebrew 已就位
打开终端，运行以下命令检查是否已安装：
brew --version
如果提示 command not found，先装 Homebrew：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
装完建议执行：
brew update && brew doctor
确保环境干净，没有权限或路径问题。
安装 PostgreSQL 并初始化数据目录
执行安装命令：
brew install postgresql
Homebrew 会装最新稳定版（如 17.x），同时附带 psql、pg_dump、createdb 等全套工具。
安装完成后，PostgreSQL 数据目录尚未创建，需手动初始化（首次必须）：
- Apple Silicon（M1/M2/M3）： initdb /opt/homebrew/var/postgres
- Intel Mac： initdb /usr/local/var/postgres
这一步会生成配置文件、预置系统用户，并设置默认认证方式为 peer（即信任当前 macOS 用户名）。
启动服务并设为开机自启
用 Homebrew Services 管理服务最方便：
brew services start postgresql
该命令会立即启动服务，并注册 launchd 任务，实现开机自动运行。
常用操作还有：
- brew services stop postgresql —— 停止服务
- brew services restart postgresql —— 重启服务
- brew services list | grep postgresql —— 查看状态（running 或 none）
服务默认监听 localhost:5432，无需额外配置即可连接。
首次登录与基础配置
PostgreSQL 默认以当前 macOS 用户名作为数据库超级用户，无密码：
psql -U $(whoami) -d postgres
进入 psql 后，执行：
\password
输入新密码完成设置。退出用 \q。
验证是否生效：
psql -U $(whoami) -d postgres -W（-W 强制弹出密码输入）
成功连接后，可创建数据库：
createdb myapp
如遇 permission denied，说明未用系统用户名登录——不要硬建 postgres 角色，Homebrew 设计就是“你即管理员”，强行切角色反而容易触发 peer 认证失败。
验证服务是否真正跑起来
重启 Mac 后，运行：
pg_isready
返回 /opt/homebrew/var/postgres accepting connections 表示服务已就绪。
也可查进程：
ps aux | grep postgres
应看到多个 postgres 进程（如 postmaster）。日志默认在：
- Apple Silicon：/opt/homebrew/var/log/postgresql.log
- Intel：/usr/local/var/log/postgresql.log
出错时优先看这个日志的最后三行，通常能准确定位是权限、端口占用还是配置语法问题。
