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 成功时通常不输出内容;数据库名已存在时会报错,应改用新的练习名称或先确认现有数据用途。

bash
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;"

预期输出

text
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。卸载软件前必须先确认数据目录和备份,因为卸载命令与数据清理不是同一个概念,不能把“删除程序”当作安全的数据迁移方式。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

在 macOS 上安装 PostgreSQL

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通