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 服务状态,并连接默认数据库执行查询。

powershell
$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;"

预期输出

text
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 修改端口;修改后客户端和应用配置必须保持一致。

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

目录与阅读设置

阅读设置

17

记录一个想法

在 Windows 上安装 PostgreSQL

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

登录哪都通