PostgreSQL 本地使用指南
在 localhost:5432 安装与连接 PostgreSQL，供 Django、Rails、Node 等应用本地开发使用。
PostgreSQL（常简称 Postgres）是功能强大的开源关系型数据库，Django、Rails、NestJS TypeORM 等栈广泛使用。本地默认监听 localhost:5432。
默认连接信息
| 项 | 典型本地值 |
|---|---|
| 主机 | localhost 或 127.0.0.1 |
| 端口 | 5432 |
| 用户 | postgres（安装时创建） |
| 密码 | 安装时设定 |
连接 URL 示例：
postgresql://postgres:password@localhost:5432/myapp安装方式
macOS（Homebrew）：
brew install postgresql@16
brew services start postgresql@16Ubuntu/Debian：
sudo apt install postgresql postgresql-contrib
sudo systemctl start postgresqlDocker：
docker run -d --name pg -p 5432:5432 \
-e POSTGRES_PASSWORD=secret \
-e POSTGRES_DB=myapp \
postgres:16Windows：从 postgresql.org 下载安装包，或使用 Docker Desktop。
命令行常用操作
psql -h localhost -U postgres
CREATE DATABASE myapp;
\l # 列出数据库
\q # 退出与框架配合
| 框架 | 配置示例 |
|---|---|
| Django | DATABASES['default']['HOST'] = 'localhost', PORT = 5432 |
| Laravel | .env 中 DB_CONNECTION=pgsql, DB_PORT=5432 |
| Node (pg) | new Client({ host: 'localhost', port: 5432, ... }) |
图形化管理
- pgAdmin：Web/Desktop 客户端
- DBeaver、TablePlus：通用数据库工具
- Adminer / phpMyAdmin：Adminer 也支持 PostgreSQL
常见问题
连接被拒绝
确认服务已启动：brew services list 或 sudo systemctl status postgresql。
role “postgres” does not exist
macOS Homebrew 可能默认当前系统用户为超级用户，用 psql postgres 或 createuser 创建角色。
与 MySQL 端口混淆
PostgreSQL 固定 5432，MySQL 为 3306。
小结
PostgreSQL 本地开发连接 localhost:5432，可用 Homebrew、系统包管理器或 Docker 安装，是现代全栈项目的主流数据库选择之一。