postgres.app和homebrew是macos上快速配置postgresql开发环境的两种主流方式：前者拖入即用、支持多版本切换；后者命令行友好、便于长期维护与ci/cd集成，均可5分钟内完成基础可用环境。
在 macos 上为开发环境快速配置 postgresql，核心是“够用、稳定、易管理”——不需要生产级复杂度，但要能秒启、秒连、不踩坑。推荐两种主流路径：轻量即用选 postgres.app，灵活可控选 homebrew。两者都能 5 分钟内完成基础可用环境。
Postgres.app：拖入即用，适合纯开发调试
适合不想碰命令行、需要多版本切换、或经常重装系统的人。
- 去官网或 GitCode 仓库下载最新 .dmg 文件（认准蓝色大象图标），拖进
Applications文件夹 - 双击启动，菜单栏出现大象图标 → 点击它，选择 Initialize 创建默认实例（自动监听
localhost:5432） - 终端里直接输入
psql就能连接，默认数据库名、用户名都和当前系统用户一致，无需密码 - 如需切换 PostgreSQL 版本，点击菜单栏图标 → Open Settings → 在 Versions 标签页下载并切换，不同项目可各自绑定版本
Homebrew：命令行友好，适合长期维护项目
适合习惯终端操作、需要自定义数据目录、或后续要集成 CI/CD 的开发者。
macOS Automator Services
下载
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...
- 先确保 Homebrew 已安装：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装指定版本（推荐带版本号，避免升级冲突）：
brew install postgresql@15 - 初始化数据目录：
initdb /opt/homebrew/var/postgresql@15（Apple Silicon 路径；Intel 用/usr/local/var/postgres） - 启动服务：
brew services start postgresql@15，之后系统重启也会自动拉起 - 验证：
psql --version和psql -U $(whoami)应能成功进入交互界面
连接与验证：确认环境真正就绪
无论用哪种方式，都要做这三件事来排除常见问题：
- 检查端口是否被占用：终端运行
lsof -i :5432，若已有进程占着，可在 Postgres.app 设置里改端口，或在 Homebrew 启动时加-p 5433 - 确认
psql命令可用：如果提示command not found，说明 PATH 没配好。Homebrew 用户需补上：echo 'export PATH="/opt/homebrew/opt/postgresql@15/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 测试应用连接：用任意客户端（如 DBeaver、TablePlus 或代码里
pg.connect("postgresql://localhost:5432")）尝试新建连接，成功即代表开发环境闭环完成
小贴士：避开新手高频坑
很多卡点其实就一两步：
- macOS Sequoia（15.x）及以上系统，首次运行 Postgres.app 可能提示“无法打开，因为 Apple 无法验证其来源”——右键 App → “显示简介” → 勾选“仍要打开”
- Homebrew 安装后
psql报role "xxx" does not exist？说明初始化没走完，重新执行initdb并确认路径无误 - 想用 pgAdmin 但找不到入口？Postgres.app 不自带，可单独
brew install --cask pgadmin4；Homebrew 安装的 PostgreSQL 也不含 GUI，需另装
