PostgreSQL / 系统课时
在 macOS 上安装 PostgreSQL
在 macOS 上安装 PostgreSQL
本课完成 macOS 环境下的 PostgreSQL 安装、启动与连接验证。结束后,你将能通过 Homebrew 管理数据库服务,创建练习数据库,并理解 macOS 默认角色与 Windows 安装方式的差异。
学习目标
- 使用 Homebrew 安装并启动 PostgreSQL
- 创建数据库并通过
psql完成连接验证 - 处理命令找不到、服务未启动和角色名错误等问题
安装前检查
先在终端执行 brew --version。能够显示版本号说明 Homebrew 已可用;若命令不存在,应先按 Homebrew 官方说明完成安装,并根据提示把 brew shellenv 加入当前 Shell 配置。
确认磁盘有足够空间,并避免手工修改 Homebrew 管理的数据目录。Apple Silicon 与 Intel Mac 的 Homebrew 安装路径可能不同,因此优先使用 brew 命令管理软件,不要在教程中硬编码包目录。
安装并启动服务
执行 brew install postgresql 安装当前 Homebrew 提供的稳定版本。安装完成后,使用 brew services start postgresql 注册并启动用户级后台服务。
Homebrew 安装通常会创建与当前 macOS 用户同名的数据库角色,不一定存在名为 postgres 的角色。因此首次连接时可以省略 -U postgres,直接使用当前系统用户名。
创建并验证数据库
以下命令适用于首次安装后的练习环境。createdb 成功时通常不输出内容;数据库名已存在时会报错,应改用新的练习名称或先确认现有数据用途。
brew install postgresql
brew services start postgresql
psql --version
brew services list | awk 'NR == 1 || $1 ~ /^postgresql/'
createdb anystack_demo
psql -d anystack_demo -c "SELECT current_database() AS database_name, current_user AS user_name;"预期输出
psql (PostgreSQL)
Name Status User File
postgresql started
database_name | user_name
---------------+-----------
anystack_demo |
(1 row)公式名称可能带版本后缀,、 与 `` 也会随机器变化。最后一条查询成功,说明客户端、服务、默认角色和练习数据库均可用。
常见问题处理
出现 command not found: brew 时,通常是 Homebrew 未安装或 Shell 环境变量未加载。按照安装结束时给出的 brew shellenv 提示更新 ~/.zprofile 或当前 Shell 对应配置,再重新打开终端。
出现“连接文件不存在”或“连接被拒绝”时,执行 brew services list 检查状态;必要时使用 brew services restart postgresql 重启。出现“角色 postgres 不存在”时,不要立即重装,先使用当前 macOS 用户名连接并查询 current_user。
停止与卸载边界
临时停止服务可以执行 brew services stop postgresql。卸载软件前必须先确认数据目录和备份,因为卸载命令与数据清理不是同一个概念,不能把“删除程序”当作安全的数据迁移方式。