企业官网建设流程全解析

做后端开发的人，电脑上迟早会装一个数据库。如果你接触开源技术栈、搞过数据分析、或者接手过一些偏传统的信息管理系统，大概率都会碰到同一个名字：PostgreSQL。它是目前功能最全面的开源关系型数据库之一，复杂查询、事务处理、数据完整性控制这些能力都相当扎实，这几年身边用的人越来越多，很多服务端项目直接把它当主力库使用。

但真正上手的第一步就没那么顺畅了。PostgreSQL 虽然提供了针对 Windows 的图形化安装包，可一路点下来，很多人还是会在莫名其妙的地方卡住：安装时设置的密码忘了、5432 端口被占、装完之后 Navicat 死活连不上、认证方式报错……我见过不少同事在连接这一步反复折腾，最后发现根本不是大问题，只是某个配置没注意到。这篇文章就把"Windows 安装 PostgreSQL + Navicat 连接 + 报错排查"整条链路一次性讲透，你按步骤操作，正常情况下几分钟就能把库跑起来，已经把库装好但一直连不上的，也能在这份教程里找到对应的解法。

1. 装 PostgreSQL 之前，先把这几件事想清楚

1.1 PostgreSQL 到底是什么，为什么值得装

PostgreSQL 本质是一个对象关系型数据库管理系统，开源、免费，而且功能覆盖面非常广。普通的增删改查它当然没问题，但它的价值远不止于此：多表复杂联查、窗口函数、递归查询、JSON 字段处理、全文检索、物化视图，甚至空间地理数据（配合 PostGIS）都能做。很多数据分析平台、地理位置服务、企业级后端系统，数据库层都选的 PG。这也是为什么它被很多人称为"开源数据库里最像 Oracles 的存在"。

那为什么要在 Windows 上装？最常见的是两种场景。第一种是本地开发联调：代码写完了，要在自己电脑上起一个数据库来测接口，PG 作为和线上环境一致的数据库，本地装一份再合适不过。第二种是学习入门：很多刚接触数据库的人会从 PG 开始，因为它的 SQL 标准遵循度高，写出来的查询语句习惯更规范，以后切换到别的数据库也更容易适应。

有人可能会问，MySQL 不是更火吗？确实，MySQL 在 Web 领域听得更多，但 PG 在标准约束、数据完整性、复杂查询优化方面做得更深入。你从 MySQL 转过来之后，最直观的感受就是：原来很多要靠"技巧"才能实现的查询，在 PG 里用标准语法就写出来了。这里我不做谁好谁坏的判断，只说你既然遇到了"Windows 安装 PostgreSQL"这个需求，说明你已经在接触 PG，那这篇就是为你准备的。

1.2 安装前必须想好的三件事：版本、端口、密码

安装之前，有几件事我建议你先想清楚，省得装到一半后悔。

版本选择上，去官方下载页面选择 "Windows x86-64" 的安装包即可。现在稳定版是 16.x 系列，17 虽然也已经发布了，但我的建议是稳定优先，选 16 系列就好。不要因为好奇去装 RC 版或 Beta 版，数据库是干活用的，不是用来尝鲜的，新版刚出来时的插件兼容性、第三方客户端适配都可能还没跟上，没必要给自己找麻烦。

端口方面，PG 默认监听 5432。如果你电脑上以前装过其他版本的 PostgreSQL，或者有别的程序占用了 5432，安装时就会报错。所以动手之前先确认一下端口情况，具体怎么查，后面第 4 章我会专门讲。

密码方面，安装过程中会要求你设置一个超级用户 postgres 的密码，这是安装后所有连接动作的总钥匙。Navicat 要连、pgAdmin 要连、命令行要连，全都靠它。我的习惯是装完立刻把密码记到密码管理器里，如果你没有这个习惯，至少写在某个自己能找到的地方，千万别一路"下一步"装完发现密码根本没记住，那就非常被动了。

2. Windows 安装 PostgreSQL 的完整流程

2.1 下载安装包：版本选择和下载细节

打开官方下载页面，找到 PostgreSQL for Windows 的入口，选择 Windows x86-64 版本。它是打包好的图形化安装器，体积大概 300 多 MB，下载速度一般还可以。这里注意两点：一是别选成源码包，源码包是给 Unix 环境编译用的，Windows 用户直接拿安装器；二是下载完之后可以看一眼文件大小，如果明显偏小，很可能下载不完整，重新下载或者换个网络环境再说。

安装包下载好之后，建议右键选择"以管理员身份运行"。虽然普通的双击也能启动安装向导，但后续安装服务、写入系统配置这一系列操作都需要管理员权限，提前用管理员运行可以避免一些莫名其妙的问题。

2.2 安装向导一步步走完，每一步都别跳过

整个安装过程是一个标准的图形化向导，大部分情况一路 Next 就能完成，但有几步的选项值得认真看一眼。

第一步是选择安装目录。默认是C:\Program Files\PostgreSQL\16。如果你的 C 盘空间不太宽裕，可以改到 D 盘，比如D:\Program Files\PostgreSQL\16。这个路径后面找命令工具时会用到，建议截图或者记一下。

第二步是选择组件。共四个选项：

• PostgreSQL Server：数据库本体，必装
• pgAdmin 4：图形化管理工具，建议装，虽然你用 Navicat 更多，但 pgAdmin 是排查问题时的备用手段
• Stack Builder：额外环境安装工具，不装，装了也用不上
• Command Line Tools：命令行工具（psql、pg_dump 等），一定要装，这是后续排查和备份的利器

第三步是选择数据目录。默认会放在安装目录下面，但我个人建议单独指定一个数据目录，比如D:\PostgreSQLData\16\data。这样重装软件时数据不会一起被清掉，逻辑上也更清晰。

第四步是设置超级用户密码。这里的用户默认是 postgres，你就把这个密码当成数据库的 root 密码来对待，设一个你能记住但又不要太简单的。记住，这个密码丢失后的找回流程比较麻烦，尽量别走到那一步。

第五步是设置端口。默认 5432，如果之前排查过发现 5432 已经被占用，这里可以直接改成 5433 或者别的未占用端口。改端口不是坏事，只要你能记住，后续连接时把端口填对就行。

第六步是区域设置（Locale）。默认是[Default locale]，用系统当前的区域，也可以手动选 C。这里其实影响的是数据库的排序规则和字符串比较方式，如果你没有特殊的多语言排序需求，默认就够用。我习惯选 C，因为它在排序上更可控，也避免某些本地化规则在查询时给你"惊喜"。

最后安装程序会执行组件安装和服务注册，等进度条走完就到完成页。注意，最后一个页面会默认勾选运行 Stack Builder，把这个勾去掉，直接点 Finish。

2.3 装完怎么确认它是真的能跑

安装完成不代表万事大吉，建议按下面三步验证一下。

第一步，验证命令行工具。打开命令提示符，执行：

psql --version

如果提示"不是内部或外部命令"，说明命令没进 PATH。别慌，直接到安装目录的 bin 文件夹下执行：

C:\Program Files\PostgreSQL\16\bin\psql --version

能看到版本号就说明装好了。

第二步，验证服务状态。在 Windows 搜索栏输入"服务"，打开服务管理器，找到postgresql-x64-16这条服务，看它的状态是不是"正在运行"。如果是"停止"状态，右键手动启动它。从这里也可以设置服务的启动类型，我建议把它改成"自动"，这样重启电脑之后数据库会自动跑起来，省得每次开机都要手动启动。

第三步，验证能否登录数据库。打开 pgAdmin 4，第一次启动会让你设置一个主密码，这个密码只是保护 pgAdmin 本地配置的，和数据库密码不是一回事，随便设一个自己能记住的就行。进去之后右键服务器→连接，输入 postgres 用户和安装时设置的密码。能连上，说明整个安装链路是通的。

3. Navicat 连接 PostgreSQL 的详细步骤

3.1 为什么我推荐用 Navicat

pgAdmin 4 功能确实全，但它是网页形式的界面，每次加载都比较重，操作起来也总觉得不够顺手。你可以把它理解成"原厂诊断仪"，功能强大但不常用。日常开发和调试，我更推荐用 Navicat。

Navicat 是传统桌面客户端，连接管理、表结构设计、数据浏览、SQL 编辑、数据导入导出这些高频操作都做得非常顺手，而且它同时支持 PostgreSQL、MySQL、SQL Server 等多种数据库，一个客户端就能统一管理，不用每个数据库装一个工具。特别是你如果平时要管理好几个库，Navicat 的连接保存、收藏夹功能能省去大量重复输入连接信息的麻烦。我自己用下来的感受是：十个问题里，pgAdmin 能用 3 分钟找到的配置项，Navicat 30 秒就能点到，效率差距很明显。

3.2 新建连接，每个字段怎么填

打开 Navicat，在左侧连接管理区域点击"连接"，选择"PostgreSQL"，会弹出一个连接配置窗口。这里的字段看起来多，其实核心只有几个。

连接名是一个本地标识，写什么都行，我一般直接写项目名，比如"本地开发库"。主机写localhost或127.0.0.1，这两个指向的都是本机，效果一样。端口写5432，如果你安装时改了端口，这里就写你改的那个。初始数据库写postgres，这是安装时自动创建的默认数据库，用它先连上来，后续可以在 Navicat 里创建你自己的业务库。用户名写postgres，密码填写安装时设置的那个。

全部填完之后，先不要急着点确定，点击左下角的"测试连接"按钮。如果连接成功，会弹出一个绿色对勾的提示框。到这个状态，点保存，左侧就会多出一个数据库连接，双击展开就能看到数据库和表结构了。

第一次连接如果弹出 SSL 相关的确认提示，直接点确认即可。PostgreSQL 默认在本地连接时会尝试协商 SSL，这个不会影响正常使用。

3.3 决定能否连上的隐藏因素

有时候你把上面的字段填得完全正确，测试连接依然报错。如果遇到这种情况，别怀疑自己眼睛，先按下面这几个方面排查。

一是 PG 服务有没有启动。很多“连接不上”的问题追根到底，就是服务没跑起来。你先去看一眼服务管理器里postgresql-x64-16的状态，不是"正在运行"就启动它。

二是防火墙有没有拦截 5432 端口。虽然本地通过 localhost 连接一般不触发防火墙拦截，但如果你用机器 IP 去连，或者 Windows 的防火墙策略比较严格，就有可能出现连接超时。这时候需要在防火墙的入站规则里放行 5432 端口，或者至少允许 PostgreSQL 程序进程通信。

三是认证配置是不是兼容。PostgreSQL 的客户端认证由数据目录下的pg_hba.conf文件控制，如果里面的认证方式配置和 Navicat 的连接方式不匹配，就会在密码验证阶段报错。这个文件默认配置对本地连接是允许的，一般不用动，但如果你之前手改过，就有必要检查一下。后面报错章节我会给出具体处理方式。

4. 常见报错与排查技巧实录

4.1 报错："connrefused" 或 "Is the server running on host ... and accepting TCP/IP connections on port 5432"

这是最常见的连接报错，字面意思是连接被拒绝，服务端没接住你的请求。三个原因按出现概率排：服务没启动、端口写错、程序被防火墙挡了。

先查服务。打开服务管理器，确认postgresql-x64-16是"正在运行"。如果没有，右键启动；如果启动还失败，大概率是数据目录存在问题，这个情况少见，得去看数据目录下的日志文件。

再查端口。如果你安装时改了端口，Navicat 里还填着 5432，那必然是连不上的。这个只能靠你回忆当时的设置。不确定的话，可以用命令行确认 PG 实际监听的端口：

netstat -ano | findstr 5432

没有任何输出说明当前 5432 上没有进程在监听，要么服务没起，要么监听的是别的端口。换成 5433、5434 再查一遍，总会有结果。

如果服务在跑、端口也对，那就检查防火墙。Windows Defender 防火墙在首次安装 PG 时可能会弹窗询问是否允许通信，如果你点了取消，后面就会一直连接失败。解决方式：控制面板→系统和安全→Windows Defender 防火墙→允许应用通过防火墙，找到 PostgreSQL 相关项，勾选专用网络和公用网络，确定保存。

4.2 报错：password authentication failed for user "postgres"

这个报错很明确：密码不对。你可能会说"我密码明明填对了"，但真实场景里，密码填错的原因可能是安装时设置的密码和你记忆中的不一样，也可能是在 pgAdmin 里改过密码后没有同步到连接工具。

如果你还能通过 pgAdmin 正常登录，那就好办。在 pgAdmin 左侧找到登录角色，右键"postgres"，选择"属性"，在定义标签页重新设置密码，保存。之后 Navicat 用新密码再连。

如果你连 pgAdmin 都登不进去，那就只能走命令行重置密码的流程。步骤如下：

第一步，找到数据目录下的pg_hba.conf文件。数据目录在安装时如果没改过，一般在安装目录下的data文件夹里；如果你像我一样单独指定了数据目录，就去那个目录找。用文本编辑器打开它，找到最前面几行以host开头的行，把认证方法scram-sha-256（或md5）临时改成trust。

第二步，重启 PostgreSQL 服务。服务管理器里找到 PostgreSQL 服务，右键重启。trust认证方式意味着本地连接不需要密码。

第三步，在命令行执行：

psql -U postgres

这次应该能直接进入 psql 交互环境，然后执行：

ALTER USER postgres WITH PASSWORD '你的新密码';

第四步，把pg_hba.conf改回原来的认证方式（scram-sha-256），重启服务，用新密码连接。

注意：pg_hba.conf里的操作要谨慎，改完一定要改回来，否则数据库在本地不受密码保护，安全性会有问题。

4.3 报错：端口 5432 被占用

安装过程中如果弹出端口被占用的提示，先别急着换端口，搞清楚占用的东西是什么再做决定。

在命令行执行：

netstat -ano | findstr :5432

这条命令会列出占用 5432 的进程信息，最后一列是 PID。再用tasklist查一下这个 PID 对应什么程序：

tasklist /fi "pid eq 端口PID"

如果是你自己电脑上的其他程序，而且不影响使用，可以结束掉它；但我更推荐直接在安装时把端口改成 5433。原因很简单：杀进程是暂时方案，下次那个程序启动又会端口回来，不如让 PG 避开冲突。改端口没什么副作用，只需记住 Navicat 连接时也要填新端口。

如果遇到 5432 被占用，而且占用者是旧的 PostgreSQL 实例，就别共存了，先卸载旧版本，再装新的。两个 PG 实例同时跑在 Windows 上，服务名和端口都容易混乱，普通开发场景没必要这样折腾。

4.4 Navicat 报错：加载客户端组件失败

Navicat 连接 PostgreSQL 时报"加载 libpq 失败"或者"无法初始化客户端组件"，这个问题出现得不算多，但一出现就很让人头疼。它和数据连接无关，是 Navicat 自身和 PG 客户端库之间的兼容问题。

原因通常是 Navicat 是 32 位版本，而 PostgreSQL 是 64 位版本，两边位数不匹配。Windows 上现在基本都是 64 位系统，建议卸载 32 位 Navicat，装上 64 位版本。位数对齐后，这类问题基本就消失了。

还有一种可能是系统缺少运行库。Navicat 依赖 Visual C++ 运行库，如果机器是精简系统，可能就没装全。遇到这种情况，去安装微软官方提供的 VC++ 运行库合集，装完重启 Navicat 再试。

4.5 报错处理速查表

5. 装完之后，我会顺手做的几件事

5.1 把服务设为开机自启

开发机重启后数据库自动可用，这个体验很重要，不然每次开机都要手动开服务，很容易忘。打开服务管理器，找到postgresql-x64-16，双击，启动类型选"自动"，确定。或者直接用管理员命令行：

sc config postgresql-x64-16 start= auto

5.2 创建一个日常业务账号

全程使用 postgres 超级用户，就像用 root 账号跑日常业务一样，风险不小。建议安装完成后创建专用业务账号，并只授权它操作业务库：

CREATE USER app_user WITH PASSWORD 'StrongPass123'; CREATE DATABASE app_db OWNER app_user; GRANT ALL PRIVILEGES ON DATABASE app_db TO app_user;

这样日常开发用 app_user，维护管理用 postgres，各司其职。

5.3 备份数据库，一条命令就够了

PostgreSQL 自带的 pg_dump 是备份数据库最直接的工具。在命令行下执行：

pg_dump -U postgres -h localhost -p 5432 -d 数据库名 -f 备份文件.sql

执行后，命令行会提示输入 postgres 密码，输完等一会，当前目录就会生成 .sql 备份文件。恢复时用 psql：

psql -U postgres -d 数据库名 -f 备份文件.sql

注意，pg_dump 命令的位置在 PG 安装目录的 bin 下，如果提示找不到命令，同样是去 bin 目录执行，或者把C:\Program Files\PostgreSQL\16\bin加进系统 PATH。

5.4 卸载 PostgreSQL 时，数据目录小心处理

Windows 的卸载程序默认不会删除数据目录。如果你在卸载时看到询问"是否删除数据目录"之类的提示，选"否"——除非你确认这些数据再也不需要了。数据文件是无价之宝，宁可保留下来，也不要在卸载时因为手快酿成误删事故。卸载完成后，安装目录和数据目录如果还在，可以手动确认内容后再决定去留。

最后再分享一个排查思路：很多 Windows 上安装 PG 后连不上的问题，本质上都不是什么疑难杂症，而是"服务没起"或者"密码不对"这类细节。我自己的习惯是，遇到数据库连接问题，先看服务管理器，再看端口监听，最后才怀疑认证配置。按这个顺序排查，绝大多数问题十分钟之内都能定位。另外，如果你要把这些配置留给同事或写进文档，一定把安装目录、端口、密码这三项信息记录清楚，这三个信息丢了任何一个，后面都可能多折腾半小时。PostgreSQL 本身是个非常靠谱的数据库，Windows 上的安装链路也不复杂，只要把流程理顺了，后续的日常使用会非常省心。