# PostgreSQL Mac 端使用手册

## 目录

1. [安装 PostgreSQL](#一安装-postgresql)
2. [连接数据库](#二连接数据库)
3. [查看所有数据库](#三查看所有数据库)
4. [创建数据库](#四创建数据库)
5. [切换数据库](#五切换数据库)
6. [查看表](#六查看表)
7. [创建表](#七创建表)
8. [常用操作命令](#八常用操作命令)

---

## 一、安装 PostgreSQL

### 1.1 使用 Homebrew 安装（推荐）

```bash
# 安装 PostgreSQL（推荐使用最新版本）
brew install postgresql@18

# 或者安装其他版本
brew install postgresql@18
brew install postgresql@18
```

### 1.2 启动 PostgreSQL 服务

```bash
# 启动服务（开机自启）
brew services start postgresql@18

# 停止服务
brew services stop postgresql@18

# 重启服务
brew services restart postgresql@18

# 查看服务状态
brew services list
```

### 1.3 验证安装

```bash
# 查看版本
psql --version

# 查看 PostgreSQL 是否运行
pg_isready
```

---

## 二、连接数据库

### 2.1 使用 psql 命令行连接

```bash
# 方式1：连接到默认数据库（使用当前系统用户名）
psql

# 方式2：连接到指定数据库
psql -d postgres

# 方式3：指定用户名和数据库
psql -U postgres -d postgres

# 方式4：指定主机、端口、用户名和数据库
psql -h localhost -p 5432 -U postgres -d postgres

# 方式5：连接时输入密码（推荐用于脚本）
PGPASSWORD=your_password psql -U postgres -d postgres
```

### 2.2 连接后的提示符

连接成功后，你会看到类似这样的提示符：

```
postgres=#
```

- `postgres` 是当前连接的数据库名
- `#` 表示你是超级用户（`$` 表示普通用户）

### 2.3 退出连接

```sql
-- 方式1：使用命令
\q

-- 方式2：使用快捷键
Ctrl + D
```

---

## 三、查看所有数据库

### 3.1 在 psql 中查看

```sql
-- 方式1：使用命令（推荐）
\l

-- 方式2：使用详细模式
\l+

-- 方式3：使用 SQL 查询
SELECT datname FROM pg_database;

-- 方式4：查看数据库详细信息
SELECT 
    datname AS "数据库名",
    pg_size_pretty(pg_database_size(datname)) AS "大小",
    datcollate AS "排序规则",
    datctype AS "字符集"
FROM pg_database
ORDER BY datname;
```

### 3.2 在命令行中查看（不进入 psql）

```bash
# 列出所有数据库
psql -l

# 或者
psql -U postgres -l
```

---

## 四、创建数据库

### 4.1 基本语法

```sql
CREATE DATABASE database_name;
```

### 4.2 创建数据库示例

```sql
-- 示例1：创建简单数据库
CREATE DATABASE myapp;

-- 示例2：创建数据库（指定编码和排序规则）
CREATE DATABASE myapp 
    WITH ENCODING 'UTF8' 
    LC_COLLATE='en_US.UTF-8' 
    LC_CTYPE='en_US.UTF-8';

-- 示例3：创建数据库（指定所有者）
CREATE DATABASE myapp OWNER username;

-- 示例4：创建数据库（指定模板）
CREATE DATABASE myapp TEMPLATE template0;
```

### 4.3 创建数据库的完整选项

```sql
CREATE DATABASE database_name
    [ [ WITH ] [ OWNER [=] user_name ]
    [ TEMPLATE [=] template ]
    [ ENCODING [=] encoding ]
    [ LC_COLLATE [=] lc_collate ]
    [ LC_CTYPE [=] lc_ctype ]
    [ TABLESPACE [=] tablespace_name ]
    [ ALLOW_CONNECTIONS [=] allowconn ]
    [ CONNECTION LIMIT [=] connlimit ]
    [ IS_TEMPLATE [=] istemplate ] ];
```

### 4.4 常用参数说明

| 参数 | 说明 | 示例 |
|------|------|------|
| `OWNER` | 数据库所有者 | `OWNER myuser` |
| `TEMPLATE` | 模板数据库 | `TEMPLATE template0` |
| `ENCODING` | 字符编码 | `ENCODING 'UTF8'` |
| `LC_COLLATE` | 排序规则 | `LC_COLLATE='en_US.UTF-8'` |
| `LC_CTYPE` | 字符分类 | `LC_CTYPE='en_US.UTF-8'` |

### 4.5 创建数据库的完整示例

```sql
-- 创建生产环境数据库
CREATE DATABASE vest_mind_prod
    WITH 
    OWNER = postgres
    ENCODING = 'UTF8'
    LC_COLLATE = 'en_US.UTF-8'
    LC_CTYPE = 'en_US.UTF-8'
    TEMPLATE = template0
    CONNECTION LIMIT = 100;

-- 创建开发环境数据库
CREATE DATABASE vest_mind_dev
    WITH 
    OWNER = postgres
    ENCODING = 'UTF8'
    TEMPLATE = template0;
```

### 4.6 验证数据库是否创建成功

```sql
-- 方式1：查看所有数据库（推荐）
\l

-- 方式2：使用 SQL 查询
SELECT datname FROM pg_database WHERE datname = 'database_name';

-- 方式3：查看数据库详细信息
SELECT 
    datname AS "数据库名",
    pg_size_pretty(pg_database_size(datname)) AS "大小",
    datcollate AS "排序规则",
    datctype AS "字符集"
FROM pg_database
WHERE datname = 'database_name';
```

### 4.7 创建数据库的注意事项

1. **数据库名称规则：**
   - 必须以字母开头
   - 只能包含字母、数字、下划线和连字符
   - 不能使用 PostgreSQL 保留关键字
   - 建议使用小写字母和下划线

2. **权限要求：**
   - 需要 `CREATEDB` 权限
   - 超级用户（如 `postgres`）可以创建任何数据库

3. **模板数据库：**
   - `template0`：干净的模板，推荐使用
   - `template1`：默认模板，可以修改
   - 自定义模板：基于现有数据库创建

4. **字符编码：**
   - 推荐使用 `UTF8` 编码
   - 确保 `LC_COLLATE` 和 `LC_CTYPE` 设置正确

### 4.8 创建数据库后立即使用

```sql
-- 创建数据库
CREATE DATABASE myapp;

-- 切换到新创建的数据库
\c myapp

-- 或者退出后重新连接
\q
psql -d myapp
```

### 4.9 删除数据库

```sql
-- 删除数据库（注意：需要先断开所有连接）
DROP DATABASE database_name;

-- 删除数据库（如果存在）
DROP DATABASE IF EXISTS database_name;

-- 强制删除数据库（终止所有连接后删除）
-- 首先终止所有连接
SELECT pg_terminate_backend(pid)
FROM pg_stat_activity
WHERE datname = 'database_name' AND pid <> pg_backend_pid();

-- 然后删除
DROP DATABASE database_name;
```

### 4.10 重命名数据库

```sql
-- 重命名数据库
ALTER DATABASE old_name RENAME TO new_name;
```

---

## 五、切换数据库

### 5.1 在 psql 中切换

```sql
-- 使用 \c 命令切换数据库
\c database_name

-- 切换到指定数据库并显示连接信息
\c database_name username

-- 查看当前连接的数据库
SELECT current_database();

-- 或者使用命令
\conninfo
```

### 5.2 退出后重新连接

```bash
# 退出当前连接
\q

# 重新连接到指定数据库
psql -d database_name
```

---

## 六、查看表

### 6.1 查看当前数据库中的所有表

```sql
-- 方式1：使用命令（推荐）
\dt

-- 方式2：查看详细信息（包括大小、描述等）
\dt+

-- 方式3：使用 SQL 查询
SELECT 
    schemaname AS "模式",
    tablename AS "表名"
FROM pg_tables
WHERE schemaname = 'public'
ORDER BY tablename;

-- 方式4：查看所有表（包括系统表）
\dt *.*
```

### 6.2 查看表结构

```sql
-- 方式1：查看表结构（推荐）
\d table_name

-- 方式2：查看详细信息（包括索引、约束等）
\d+ table_name

-- 方式3：只查看列信息
\d table_name

-- 方式4：使用 SQL 查询列信息
SELECT 
    column_name AS "列名",
    data_type AS "数据类型",
    character_maximum_length AS "最大长度",
    is_nullable AS "可空",
    column_default AS "默认值"
FROM information_schema.columns
WHERE table_name = 'table_name'
ORDER BY ordinal_position;
```

### 6.3 查看表的索引

```sql
-- 查看表的所有索引
\d table_name

-- 或者使用 SQL
SELECT 
    indexname AS "索引名",
    indexdef AS "索引定义"
FROM pg_indexes
WHERE tablename = 'table_name';
```

### 6.4 查看表的约束

```sql
-- 查看表的所有约束
\d table_name

-- 或者使用 SQL
SELECT 
    conname AS "约束名",
    contype AS "约束类型",
    pg_get_constraintdef(oid) AS "约束定义"
FROM pg_constraint
WHERE conrelid = 'table_name'::regclass;
```

---

## 七、创建表

### 7.1 基本语法

```sql
CREATE TABLE table_name (
    column1_name data_type [constraints],
    column2_name data_type [constraints],
    ...
);
```

### 7.2 创建表示例

```sql
-- 示例1：创建用户表
CREATE TABLE users (
    user_id BIGSERIAL PRIMARY KEY,
    username VARCHAR(100) NOT NULL UNIQUE,
    email VARCHAR(100) UNIQUE,
    password_hash VARCHAR(255) NOT NULL,
    created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
);

-- 示例2：创建订单表（带外键）
CREATE TABLE orders (
    order_id BIGSERIAL PRIMARY KEY,
    user_id BIGINT NOT NULL,
    total_amount DECIMAL(10, 2) NOT NULL,
    status VARCHAR(20) NOT NULL DEFAULT 'pending',
    created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE CASCADE
);

-- 示例3：创建带检查约束的表
CREATE TABLE products (
    product_id BIGSERIAL PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    price DECIMAL(10, 2) NOT NULL CHECK (price > 0),
    stock INTEGER NOT NULL DEFAULT 0 CHECK (stock >= 0),
    created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
);
```

### 7.3 常用数据类型

| 数据类型 | 说明 | 示例 |
|---------|------|------|
| `BIGSERIAL` | 自增整数（64位） | `user_id BIGSERIAL PRIMARY KEY` |
| `BIGINT` | 大整数（64位） | `user_id BIGINT` |
| `INTEGER` | 整数（32位） | `age INTEGER` |
| `VARCHAR(n)` | 可变长度字符串 | `username VARCHAR(100)` |
| `TEXT` | 长文本 | `description TEXT` |
| `DECIMAL(p,s)` | 精确小数 | `price DECIMAL(10, 2)` |
| `BOOLEAN` | 布尔值 | `is_active BOOLEAN` |
| `DATE` | 日期 | `birthday DATE` |
| `TIMESTAMP` | 时间戳 | `created_at TIMESTAMP` |
| `JSONB` | JSON 二进制 | `metadata JSONB` |

### 7.4 常用约束

```sql
-- PRIMARY KEY：主键
user_id BIGSERIAL PRIMARY KEY

-- NOT NULL：非空
username VARCHAR(100) NOT NULL

-- UNIQUE：唯一
email VARCHAR(100) UNIQUE

-- DEFAULT：默认值
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP

-- CHECK：检查约束
price DECIMAL(10, 2) CHECK (price > 0)

-- FOREIGN KEY：外键
user_id BIGINT REFERENCES users(user_id)

-- 组合约束
CONSTRAINT pk_user PRIMARY KEY (user_id),
CONSTRAINT uk_email UNIQUE (email),
CONSTRAINT fk_order_user FOREIGN KEY (user_id) REFERENCES users(user_id)
```

### 7.5 验证表是否创建成功

```sql
-- 查看所有表
\dt

-- 查看表结构
\d table_name

-- 查看表是否存在
SELECT EXISTS (
    SELECT FROM information_schema.tables 
    WHERE table_name = 'table_name'
);
```

---

## 八、常用操作命令

### 8.1 数据库操作

```sql
-- 创建数据库
CREATE DATABASE database_name;

-- 创建数据库（指定编码）
CREATE DATABASE database_name 
    WITH ENCODING 'UTF8' 
    LC_COLLATE='en_US.UTF-8' 
    LC_CTYPE='en_US.UTF-8';

-- 删除数据库
DROP DATABASE database_name;

-- 重命名数据库
ALTER DATABASE old_name RENAME TO new_name;
```

### 8.2 表操作

```sql
-- 删除表
DROP TABLE table_name;

-- 删除表（如果存在）
DROP TABLE IF EXISTS table_name;

-- 清空表数据（保留表结构）
TRUNCATE TABLE table_name;

-- 重命名表
ALTER TABLE old_name RENAME TO new_name;

-- 添加列
ALTER TABLE table_name ADD COLUMN column_name data_type;

-- 删除列
ALTER TABLE table_name DROP COLUMN column_name;

-- 修改列类型
ALTER TABLE table_name ALTER COLUMN column_name TYPE new_type;

-- 添加约束
ALTER TABLE table_name ADD CONSTRAINT constraint_name CHECK (condition);
```

### 8.3 数据操作（CRUD）

```sql
-- 插入数据
INSERT INTO users (username, email, password_hash) 
VALUES ('john', 'john@example.com', 'hashed_password');

-- 查询数据
SELECT * FROM users;
SELECT username, email FROM users WHERE user_id = 1;

-- 更新数据
UPDATE users SET email = 'newemail@example.com' WHERE user_id = 1;

-- 删除数据
DELETE FROM users WHERE user_id = 1;
```

### 8.4 psql 常用命令

```sql
-- 帮助命令
\?          -- 查看所有命令
\h          -- SQL 命令帮助
\h CREATE TABLE  -- 查看特定 SQL 命令帮助

-- 数据库相关
\l          -- 列出所有数据库
\c dbname   -- 连接到数据库
\conninfo   -- 显示当前连接信息

-- 表相关
\dt         -- 列出所有表
\d table    -- 查看表结构
\d+ table   -- 查看表详细信息

-- 其他
\q          -- 退出
\du         -- 列出所有用户
\dn         -- 列出所有模式（schema）
\df         -- 列出所有函数
\timing     -- 开启/关闭执行时间显示
\x          -- 开启/关闭扩展显示（用于宽表）
```

### 8.5 查看执行计划

```sql
-- 查看查询执行计划
EXPLAIN SELECT * FROM users WHERE user_id = 1;

-- 查看详细执行计划（包含实际执行时间）
EXPLAIN ANALYZE SELECT * FROM users WHERE user_id = 1;
```

---

## 九、实用技巧

### 9.1 设置用户名和密码

#### 9.1.1 为现有用户设置密码

```sql
-- 为 postgres 用户设置密码
ALTER USER postgres WITH PASSWORD 'your_password';

-- 为当前用户设置密码
ALTER USER current_user WITH PASSWORD 'your_password';

-- 查看当前用户
SELECT current_user;
```

#### 9.1.2 创建新用户并设置密码

```sql
-- 创建新用户并设置密码
CREATE USER username WITH PASSWORD 'your_password';

-- 创建用户并指定更多选项
CREATE USER username 
    WITH PASSWORD 'your_password'
    CREATEDB  -- 允许创建数据库
    CREATEROLE;  -- 允许创建角色

-- 查看所有用户
\du
```

#### 9.1.3 为用户授予数据库权限

```sql
-- 授予数据库的所有权限
GRANT ALL PRIVILEGES ON DATABASE database_name TO username;

-- 授予特定权限
GRANT CONNECT ON DATABASE database_name TO username;
GRANT CREATE ON DATABASE database_name TO username;

-- 授予表的权限（需要先连接到数据库）
\c database_name
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO username;
GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO username;

-- 授予未来创建的表和序列的权限
ALTER DEFAULT PRIVILEGES IN SCHEMA public 
    GRANT ALL ON TABLES TO username;
ALTER DEFAULT PRIVILEGES IN SCHEMA public 
    GRANT ALL ON SEQUENCES TO username;
```

#### 9.1.4 完整示例：为新数据库设置用户和密码

```sql
-- 1. 连接到 PostgreSQL（使用超级用户）
psql -d postgres

-- 2. 创建新用户
CREATE USER vest_mind_user WITH PASSWORD 'your_secure_password';

-- 3. 授予数据库权限
GRANT ALL PRIVILEGES ON DATABASE vest_mind TO vest_mind_user;

-- 4. 切换到目标数据库
\c vest_mind

-- 5. 授予 schema 权限
GRANT ALL ON SCHEMA public TO vest_mind_user;

-- 6. 授予现有表的权限
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO vest_mind_user;
GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO vest_mind_user;

-- 7. 授予未来创建的表和序列的权限
ALTER DEFAULT PRIVILEGES IN SCHEMA public 
    GRANT ALL ON TABLES TO vest_mind_user;
ALTER DEFAULT PRIVILEGES IN SCHEMA public 
    GRANT ALL ON SEQUENCES TO vest_mind_user;

-- 8. 验证权限
\du vest_mind_user
```

#### 9.1.5 使用新用户连接数据库

```bash
# 方式1：使用密码连接
psql -U vest_mind_user -d vest_mind

# 方式2：使用环境变量（用于脚本）
PGPASSWORD=your_secure_password psql -U vest_mind_user -d vest_mind

# 方式3：在连接字符串中指定
psql "postgresql://vest_mind_user:your_secure_password@localhost:5432/vest_mind"
```

#### 9.1.6 修改用户密码

```sql
-- 修改用户密码
ALTER USER username WITH PASSWORD 'new_password';

-- 强制用户下次登录时修改密码
ALTER USER username WITH PASSWORD 'new_password' VALID UNTIL '2025-12-31';
```

#### 9.1.7 删除用户

```sql
-- 删除用户（如果用户拥有对象，需要先转移所有权）
DROP USER username;

-- 或者先转移所有权再删除
REASSIGN OWNED BY username TO postgres;
DROP OWNED BY username;
DROP USER username;
```

#### 9.1.8 配置 PostgreSQL 认证方式（可选）

如果需要强制使用密码认证，可以编辑 PostgreSQL 配置文件：

```bash
# 找到配置文件位置（Homebrew 安装）
# 通常在：/opt/homebrew/var/postgresql@18/pg_hba.conf
# 或：/usr/local/var/postgresql@18/pg_hba.conf

# 编辑配置文件
nano /opt/homebrew/var/postgresql@18/pg_hba.conf
```

在 `pg_hba.conf` 文件中，找到类似这样的行：

```
# TYPE  DATABASE        USER            ADDRESS                 METHOD
local   all             all                                     trust
host    all             all             127.0.0.1/32            trust
```

修改为需要密码认证：

```
# TYPE  DATABASE        USER            ADDRESS                 METHOD
local   all             all                                     md5
host    all             all             127.0.0.1/32            md5
```

然后重启 PostgreSQL 服务：

```bash
brew services restart postgresql@18
```

**认证方式说明：**
- `trust`：无需密码（当前默认）
- `md5`：使用 MD5 加密的密码
- `password`：使用明文密码（不推荐）
- `scram-sha-256`：使用 SCRAM-SHA-256 加密（推荐，PostgreSQL 10+）

### 9.2 导出和导入数据

```bash
# 导出数据库
pg_dump -U postgres -d database_name > backup.sql

# 导入数据库
psql -U postgres -d database_name < backup.sql

# 导出表
pg_dump -U postgres -d database_name -t table_name > table_backup.sql

# 导出为 CSV
psql -U postgres -d database_name -c "COPY table_name TO STDOUT WITH CSV HEADER" > data.csv
```

### 9.3 查看数据库大小

```sql
-- 查看当前数据库大小
SELECT pg_size_pretty(pg_database_size(current_database()));

-- 查看所有数据库大小
SELECT 
    datname AS "数据库名",
    pg_size_pretty(pg_database_size(datname)) AS "大小"
FROM pg_database
ORDER BY pg_database_size(datname) DESC;

-- 查看表大小
SELECT 
    schemaname AS "模式",
    tablename AS "表名",
    pg_size_pretty(pg_total_relation_size(schemaname||'.'||tablename)) AS "大小"
FROM pg_tables
WHERE schemaname = 'public'
ORDER BY pg_total_relation_size(schemaname||'.'||tablename) DESC;
```

### 9.4 查看连接信息

```sql
-- 查看当前连接
\conninfo

-- 查看所有活动连接
SELECT 
    pid,
    usename,
    datname,
    client_addr,
    state,
    query
FROM pg_stat_activity
WHERE datname IS NOT NULL;
```

### 9.5 环境变量配置（可选）

在 `~/.zshrc` 或 `~/.bash_profile` 中添加：

```bash
# PostgreSQL 路径配置
export PATH="/opt/homebrew/opt/postgresql@18/bin:$PATH"
export LDFLAGS="-L/opt/homebrew/opt/postgresql@18/lib"
export CPPFLAGS="-I/opt/homebrew/opt/postgresql@18/include"

# PostgreSQL 连接别名（可选）
alias pgstart='brew services start postgresql@18'
alias pgstop='brew services stop postgresql@18'
alias pgrestart='brew services restart postgresql@18'
alias pgstatus='brew services list | grep postgresql'
```

---

## 十、快速参考

### 10.1 常用连接方式

```bash
# 最简单的方式
psql

# 指定数据库
psql -d mydb

# 指定用户和数据库
psql -U postgres -d mydb

# 带密码连接（用于脚本）
PGPASSWORD=password psql -U postgres -d mydb
```

### 10.2 常用 SQL 命令速查

```sql
-- 数据库
CREATE DATABASE dbname;
DROP DATABASE dbname;
\l

-- 表
CREATE TABLE tname (...);
DROP TABLE tname;
\dt
\d tname

-- 数据
INSERT INTO tname VALUES (...);
SELECT * FROM tname;
UPDATE tname SET ... WHERE ...;
DELETE FROM tname WHERE ...;

-- 用户
CREATE USER username WITH PASSWORD 'password';
\du
```

### 10.3 故障排查

```bash
# 检查 PostgreSQL 是否运行
pg_isready

# 查看日志（Homebrew 安装）
tail -f /opt/homebrew/var/log/postgresql@18.log

# 或者
tail -f /usr/local/var/log/postgresql@18.log

# 重启服务
brew services restart postgresql@18
```

---

## 十一、示例：完整工作流程

```bash
# 1. 启动 PostgreSQL
brew services start postgresql@18

# 2. 连接到数据库
psql -d postgres

# 3. 创建数据库
CREATE DATABASE myapp;

# 4. 切换到新数据库
\c myapp

# 5. 创建表
CREATE TABLE users (
    user_id BIGSERIAL PRIMARY KEY,
    username VARCHAR(100) NOT NULL UNIQUE,
    email VARCHAR(100) UNIQUE,
    created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
);

# 6. 查看表
\dt
\d users

# 7. 插入数据
INSERT INTO users (username, email) 
VALUES ('john', 'john@example.com');

# 8. 查询数据
SELECT * FROM users;

# 9. 退出
\q
```

---

## 十二、图形化工具推荐

### 12.1 pgAdmin
- 官网：https://www.pgadmin.org/
- 功能强大的 PostgreSQL 管理工具

### 12.2 DBeaver
- 官网：https://dbeaver.io/
- 免费、跨平台的数据库管理工具

### 12.3 TablePlus
- 官网：https://tableplus.com/
- Mac 上优秀的数据库管理工具（付费）

### 12.4 Postico
- 官网：https://eggerapps.at/postico/
- Mac 专用的 PostgreSQL 客户端（付费）

---

## 十三、常见问题

### Q1: 连接时提示 "password authentication failed"
**A:** 检查用户名和密码是否正确，或者重置 postgres 用户密码：
```sql
ALTER USER postgres WITH PASSWORD 'new_password';
```

### Q2: 找不到 psql 命令
**A:** 需要将 PostgreSQL 的 bin 目录添加到 PATH：
```bash
export PATH="/opt/homebrew/opt/postgresql@18/bin:$PATH"
```

### Q3: 端口 5432 已被占用
**A:** 检查端口占用情况：
```bash
lsof -i :5432
```

### Q4: 如何查看 PostgreSQL 版本
**A:** 
```bash
psql --version
# 或者在 psql 中
SELECT version();
```

---

**文档版本：** v1.0  
**最后更新：** 2024年