PostgreSQL 18 中文参考文档(未翻译部分保留英文)🌐 切换到英文原版 →

17.3. 使用 Make 构建与安装 #

17.3.1. 配置阶段(configure)
17.3.2. 编译阶段(make)
17.3.3. 回归测试(make check)
17.3.4. 安装文件(make install)

采用经典的 Autoconf + Make 体系构建分为四大阶段:配置、编译、测试与安装。

17.3.1. 配置阶段(configure) #

在源码根目录下执行配置脚本:

./configure

该脚本会自动探测当前系统的硬件架构、编译器特性以及系统调用库,并据此生成全套物理编译 Makefile。默认安装目标前缀为 /usr/local/pgsql。常用定制配置选项包括:

--prefix=PREFIX

显式指定全部可执行文件、库文件和头文件的目标安装根目录路径。

--with-ssl=openssl

编译启用基于 OpenSSL 的 SSL/TLS 网络加密通信与证书认证能力。

--with-systemd

在 Linux 环境下编译集成对 systemd 守护进程服务生命周期通知的支持。

--enable-debug

附加调试符号(-g),便于内核排查与 GDB 堆栈追踪。

17.3.2. 编译阶段(make) #

开始编译核心系统组件:

make

也可以通过 -j 参数利用多核 CPU 加速并行编译(例如 make -j 8)。编译顺利完成的标志是终端最后输出类似如下的成功信息:

All of PostgreSQL successfully made. Ready to install.

17.3.3. 回归测试(make check) #

在将产物安装到系统之前,可以运行官方自带的回归测试套件全面验证新编译二进制文件的正确性:

make check

测试套件会自动就地拉起一个临时的隔离集群实例并运行成百上千个测试用例。如果全部测试通过,输出末尾会显示:

All 200 tests passed.

17.3.4. 安装文件(make install) #

将编译生成的全部二进制、动态库及文档文件复制部署到预设的安装目录下:

make install

(若目标安装路径位于受保护的系统目录,此步可能需要 root 权限)。若还需编译并安装官方附带的各类扩展工具(位于 contrib/ 目录下):

make -C contrib install