PostgreSQL / 系统课时
在 Windows 上安装 PostgreSQL
在 Windows 上安装 PostgreSQL
本课完成 Windows 环境下的 PostgreSQL 安装与验证。结束后,你将拥有可运行的数据库服务、psql 命令行工具和 pgAdmin,并能确认服务状态、版本信息和默认数据库连接。
学习目标
- 完成 PostgreSQL 服务端、命令行工具和 pgAdmin 的安装
- 正确设置端口、超级用户密码与数据目录
- 使用 PowerShell 验证服务和数据库连接
安装前检查
准备 64 位 Windows 10 或 Windows 11,并确认当前账号具有安装软件和注册系统服务的权限。默认端口是 5432;如果机器已有数据库占用该端口,需要改用其他端口并记录下来。
安装前确定数据目录所在磁盘。数据库会持续写入数据和事务日志,目录应有足够空间,不要放在会被自动同步、随意清理或权限不稳定的位置。
使用安装程序
从 PostgreSQL 官方 Windows 下载入口获取安装程序。安装组件至少选择 PostgreSQL Server 和 Command Line Tools;需要图形管理时选择 pgAdmin,Stack Builder 可以暂时不安装。
向导会要求设置安装目录、数据目录、postgres 超级用户密码、监听端口和区域设置。密码需要妥善保存,端口没有冲突时保持 5432 即可。
安装完成后,数据库通常以 Windows 服务方式自动启动。pgAdmin 首次打开时可能要求设置本地保护密码,该密码用于保护 pgAdmin 保存的连接信息,不等同于数据库角色密码。
验证安装结果
将 `` 替换为实际安装的主版本号。下面的 PowerShell 命令依次检查客户端版本、Windows 服务状态,并连接默认数据库执行查询。
$pgBin = "C:\Program Files\PostgreSQL\\bin"
& "$pgBin\psql.exe" --version
Get-Service -Name "postgresql*" |
Select-Object Name, Status
& "$pgBin\psql.exe" `
-h 127.0.0.1 `
-p 5432 `
-U postgres `
-d postgres `
-c "SELECT current_database() AS database_name, current_user AS user_name;"预期输出
psql (PostgreSQL)
Name Status
---- ------
postgresql-x64- Running
database_name | user_name
---------------+----------
postgres | postgres
(1 row)版本号、服务名和表格对齐方式可能不同。查询返回一行结果,说明服务启动、端口监听、密码认证和 SQL 执行都正常。
配置命令行路径
如果希望直接输入 psql,可以把 C:\Program Files\PostgreSQL\\bin 加入系统 Path,然后关闭并重新打开 PowerShell。
修改后执行 psql --version。如果仍提示无法识别命令,优先检查路径是否写到 bin 目录,以及当前终端是否在修改环境变量后重新启动。
典型失败处理
连接被拒绝时,在“服务”管理器或 PowerShell 中确认 PostgreSQL 服务为 Running,并核对安装时填写的端口。密码认证失败时,确认输入的是数据库角色 postgres 的密码,而不是 pgAdmin 本地保护密码。
若端口已被占用,不要直接结束未知进程。先确认占用者,再决定停止旧服务,或为 PostgreSQL 修改端口;修改后客户端和应用配置必须保持一致。