homebrew是macos安装postgresql最省心且贴近生产环境的方式，自动处理依赖、预设合理配置、服务管理清晰，仅需安装homebrew、执行brew install postgresql、initdb初始化、brew services start启动服务并用psql验证即可完成本地开发环境搭建。

直接用 homebrew 安装 postgresql 是 macos 上最省心、最贴近生产环境的方式。它自动处理依赖、预设合理配置、服务管理清晰，不需要创建专用用户，也不用手动调 path —— 只要几步，就能跑起一个可开发、可调试的本地实例。

安装 Homebrew（如果还没装）

打开终端，粘贴运行官方安装命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

过程中会提示输入系统密码（输入时无显示，输完回车即可），并可能自动安装 Xcode 命令行工具。安装完成后，建议立刻执行：

• brew update —— 更新包索引
• brew doctor —— 检查环境，按提示修复权限或路径问题（常见如 /opt/homebrew/bin 权限异常）

安装 PostgreSQL

运行安装命令：

brew install postgresql

默认安装最新稳定版（如 PostgreSQL 17），同时附带：
• psql 命令行客户端
• pg_dump、pg_restore、createdb 等常用工具
• 预编译二进制（bottle），无需编译，几十秒完成

安装后，数据目录自动设为：
• Apple Silicon（M1/M2/M3）：/opt/homebrew/var/postgres
• Intel Mac：/usr/local/var/postgres

初始化并启动服务

首次安装后需初始化数据库簇：

macOS Automator Services

部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...

下载

initdb /opt/homebrew/var/postgres（Apple Silicon）
initdb /usr/local/var/postgres（Intel）

然后启动服务：

• 推荐方式（后台常驻，开机自启）：
  brew services start postgresql
• 临时启动（仅当前终端会话有效）：
  pg_ctl -D /opt/homebrew/var/postgres start（Apple Silicon）
  pg_ctl -D /usr/local/var/postgres start（Intel）

验证是否运行成功：
psql --version 查版本
psql -l 列出数据库（应能看到 postgres、template0、template1）

连接与基本配置

默认情况下，PostgreSQL 使用当前 macOS 用户名作为数据库超级用户，无需密码即可登录：

psql -U $(whoami) -d postgres

如果想切换成传统 postgres 用户并设密码：

• 先创建角色：createuser --superuser postgres
• 再设密码：psql -c "ALTER USER postgres PASSWORD 'your_password';"
• 修改 pg_hba.conf（位于数据目录下），把对应行改为 local all postgres md5，然后 reload：pg_ctl -D /opt/homebrew/var/postgres reload

注意：Homebrew 安装不默认启用远程访问，如需局域网连接，需额外修改 postgresql.conf 中的 listen_addresses 和防火墙设置。