必须以管理员身份运行安装包,选English界面,安装路径设D:\PostgreSQL\18,勾选Server、pgAdmin4和命令行工具,数据目录单独设D:\PostgreSQL\data,postgres密码需8位以上含大小写字母数字且不含$@!等特殊字符,安装后验证服务运行、psql命令可用及pgAdmin成功连接。

要在Windows本地安装PostgreSQL数据库及配套管理工具pgAdmin,必须一次性完成服务注册、中文环境适配、密码安全设定和命令行可用性验证,否则后续连接会反复报错“password authentication failed”或“psql不是内部命令”。
下载并以管理员身份运行安装包
访问 https://www.postgresql.org/download/windows/ → 点击“Download the installer” → 选择“Windows x86-64” → 下载 postgresql-18.x-windows-x64.exe(当前最新稳定版为18.4)→ 右键安装文件 → 选择“以管理员身份运行”。【不以管理员身份运行会导致Windows服务注册失败,且无法写入Program Files目录】
安装向导语言选English(中文翻译存在多处漏译,比如“Stack Builder”被错译为“堆栈构建器”,易误导操作)。
关键配置四步设置
第一步:安装路径选D:\PostgreSQL\18(避开C:\Program Files含空格路径,否则pg_ctl启动时会解析失败)。
第二步:组件勾选PostgreSQL Server、pgAdmin 4、Command Line Tools(Stack Builder可不选,学习阶段用不到扩展生态)。
第三步:数据目录单独设为D:\PostgreSQL\data(与安装目录分离,便于日后迁移或重装时保留数据)。
让 Windows 桌面程序在开机时静默自启并隐藏到系统托盘。特别适用于 Flutter、Electron 等无视 VBS/ProcessStartInfo 窗口样式、难以隐藏的顽固应用。提供「VBS 启动器 + Python ctypes/Win32 API」的隐藏窗口方案,可稳定把窗口收进托盘且不闪控制台。
第四步:超级用户postgres密码必须同时满足——8位以上、含大小写字母+数字、不含$、@、!等特殊字符(这些字符在Windows服务启动脚本中未做转义,会导致pg_hba.conf认证环节静默失败)。
安装后立即验证的三项动作
方法一:检查Windows服务是否真正在运行
按Win+R输入services.msc → 找到服务名postgresql-x64-18 → 确认“状态”列为“正在运行”,“启动类型”为“自动”。若显示“已停止”,右键→启动,此时不要点“重试”,先看日志:打开D:\PostgreSQL\data\log\下的最新.log文件,搜索FATAL字样。
方法二:测试psql命令是否可用
Win+R输入cmd → 输入psql --version → 回车。若提示“不是内部或外部命令”,说明环境变量没生效:右键“此电脑”→属性→高级系统设置→环境变量→系统变量→Path→新建→粘贴D:\PostgreSQL\18\bin→确定→重启cmd窗口再试。
方法三:用pgAdmin首次连接数据库
开始菜单打开pgAdmin 4 → 左侧浏览器树中右键“Servers”→“Create”→“Server”→General页填Name为local_pg18 → Connection页填Host name/address为localhost,Port为5432,Username为postgres,Password填第四步设的密码→保存。若弹出“Unable to connect…”错误,90%是密码里用了特殊字符或服务根本没起来。










