企业官网建设流程全解析

• 数据库
• 桌面应用

Postgres.app 是 macOS 上以原生 App 形态打包的完整 PostgreSQL 发行版，其官方下载页是用户获取安装包的第一入口。本文基于仓库中的德语下载页 docs/de/downloads.md 及其对应的英文版 docs/downloads.md，完整梳理下载页的"当前版本 / 附加版本 / 旧 Mac 版本"三层结构，结合驱动页面渲染的 docs/_config.yml 与 docs/_includes/release.html，给出每个安装包所包含的 PostgreSQL、PostGIS 版本、体积与系统要求，并延伸到下载后的安装、$PATH配置与连接验证。读完后你将能根据自己运行的是哪种 macOS、需要哪个 PostgreSQL 大版本、是否要同时运行多个版本，快速选出正确的安装包。

下载页的整体结构：三类下载入口

德语下载页docs/de/downloads.md用三个小节组织所有下载内容，英文版结构与之对应：

1. Aktuelle Version（当前版本）：官方推荐给新用户的版本，官方表述为"包含你使用 PostgreSQL 与 PostGIS 所需的一切"；
2. Zusätzliche Versionen（附加版本）：为需要其他 PostgreSQL 版本的开发者提供，官方明确指出"可以借助 Postgres.app 同时运行多个不同的 PostgreSQL 版本"；
3. Für ältere Macs（旧 Mac 版本）：为未升级到新版 macOS 的用户提供历史版本入口，指向 docs/de/downloads_legacy.md。

页面本身并不硬编码任何版本号，而是通过 Jekyll 变量site.release、site.extraReleases与site.legacyReleases循环渲染每个发布条目：

{% include release.html release=site.release %} {% for release in site.extraReleases %} {% include release.html release=release %} {% endfor %}

这意味着你看到的每一组"版本名 + 体积 + 系统要求 + 下载按钮"，都源自站点配置文件中的结构化数据（详见下文"下载信息由哪些文件驱动"一节）。

当前版本（Latest Release）：一份安装包开箱即用

根据 docs/_config.yml 中release字段，当前正式版本（当前仓库所记录的状态）为：

下载页对它的定位非常明确：如果你是 PostgreSQL 新手，应该下载这个文件。它不仅包含数据库引擎本身，还集成了开箱即用的空间数据库扩展 PostGIS，以及仓库 README.md 所列出的扩展组件：wal2json（逻辑复制解码插件）、pldebugger（PL/pgSQL 调试器）、PostgreSQL 15 及以上版本附带pgrouting与pgvector，PostgreSQL 13 及以下附带plv8（JavaScript 存储过程语言），PostgreSQL 14 及以上附带pljs。也就是说，单份安装包即可覆盖绝大多数本地开发与空间数据处理场景，无需再手工编译任何扩展。

附加版本（Additional Releases）：多版本并行与按需裁剪

如果你需要运行其他 PostgreSQL 大版本，下载页的extraReleases段落提供两类选择：

• 聚合包：把当前所有受支持版本打进同一个.dmg，一次下载、按需切换；
• 单版本包：只包含某一个 PostgreSQL 大版本，体积更小、更聚焦。

以 docs/_config.yml 中extraReleases的实际数据为准，可整理出如下版本矩阵：

多版本并行的底层依据

下载页强调"可以同时使用不同 PostgreSQL 版本"，这在仓库的架构设计中是有据可循的：README.md 的 "Under the Hood" 一节说明，每个服务器实例有独立的数据目录，默认路径为~/Library/Application Support/Postgres/var-XX，其中XX是 PostgreSQL 主版本号。首次启动时 Postgres.app 会执行initdb -D DATA_DIRECTORY初始化数据库集群，随后用pg_ctl start启动并创建与系统用户名同名的超级用户与数据库。由于不同大版本各自使用var-14、var-15这样的独立目录与端口配置，多个版本可以互不干扰地共存于同一台 Mac 上。这也是"所有受支持版本聚合包"能落地的基础。

预发布版本：PostgreSQL 19 Beta

extraReleases中还包含两条带Pre-release（预发布）徽标的条目，面向希望提前体验新特性的用户：

• Postgres.app mit PostgreSQL 19 Beta：包含 PostgreSQL 19beta3 与 PostGIS 3.7.0rc1（Universal），Postgres.app 版本为 3alpha9，体积 127 MB，最低系统 macOS 11；
• Postgres.app mit PostgreSQL 19 Beta und allen unterstützten Versionen：在 19 Beta 之外再叠加 18.6/17.11/16.15/15.19/14.24 五个受支持版本，体积 653 MB。

在 docs/_includes/release.html 的渲染模板中，badge字段会生成Pre-release徽标（模板第 11 行{%if include.release.badge %}），让预发布条目在下载页上与正式版本一眼区分。需要留意的是，预发布包对应的 Postgres.app 版本号（3alpha9）与正式版（2.9.6）分属两条发布线，日常开发仍应以正式版为准。

旧 Mac 用户的下载通道：Legacy 下载页

德语下载页第三小节提示：如果你的 macOS 低于 10.15（当前正式版的最低要求），应前往 docs/de/downloads_legacy.md。该页明确给出两条兼容线：

• macOS 10.10 及以上：可以使用 Postgres.app v2.1.x（带现代图形界面）；
• 更老的 Mac（macOS 10.7+）：只能使用带旧界面的 "Legacy" 版本。

同时页面加注了重要警告：这些旧版本现已不再维护。该页通过site.legacyReleases渲染了跨度从 PostgreSQL 9.3 到 18 的十余个历史安装包（见 docs/_config.yml 的legacyReleases数组），例如 PostgreSQL 13–18 聚合包、PostgreSQL 12–17 聚合包、支持 macOS 10.12 的最后一版（PostgreSQL 10–14）等。其中 13 及以下的旧版本条目还额外列出了plv8版本号（如 2.3.15、1.4.8），而 14 及以上的条目则不再包含 plv8——这与 README.md 中"plv8 提供至 PostgreSQL 13、14 起改用 pljs"的组件划分完全一致，可以作为识别新旧扩展体系的一个线索。

下载信息由哪些文件驱动（配置与模板解析）

下载页本身几乎不含硬编码版本号，这正是这套站点设计的精妙之处。整个下载体系由两个文件协作驱动：

1. 数据源 docs/_config.yml：以release、extraReleases、legacyReleases三个 YAML 数组存放全部发布条目。每个条目包含：name（按语言区分的中英文版本名）、postgresappVersion（App 版本）、postgresappMinSystemVersion（最低系统版本）、size（下载体积）、downloadLocation（下载地址）、releaseNotesLocation（发布说明地址）、postgresqlVersions（内含postgres/postgis/plv8/architecture的嵌套数组）、可选的badge（徽标）。发布新版本时只需在此处增删条目，下载页即自动更新。

2. 渲染模板 docs/_includes/release.html：把单个条目渲染成 HTML 卡片。模板第 11–16 行展示标题与徽标，以及"需要 macOS 版本"、"下载体积"、"发布说明链接"三条信息；第 19–26 行遍历postgresqlVersions，逐条列出 PostgreSQL 版本、可选的 PostGIS 与 plv8 版本以及架构标识（architecture字段，例如 Universal）；第 28 行生成下载按钮，按钮文案由站点配置中的德语字符串download-button（"Laden"）或英语字符串（"Download"）决定。此外，模板第 1–8 行会根据页面路径自动判断语言：德语文档（路径含两位语言代码de）使用德语字符串，其余页面回退到英语。

这套"数据与模板分离"的做法意味着：即使你不懂 Jekyll，也可以直接从 docs/_config.yml 中读出每个安装包的确切版本构成；这也是本文所有版本数据的原始出处。

下载之后：安装、配置与连接验证

下载页聚焦"选择安装包"，而安装与验证流程在仓库的其他文档中有完整说明，这里一并串起来：

1. 安装：把 Postgres.app 拖入"应用程序"文件夹即可（见 docs/de/documentation/install.md）。官方同时提醒，若从其他位置运行，部分功能可能无法正常工作；
2. 初始化服务器：首次双击打开后点击 "Initialize"，Postgres.app 会执行initdb初始化数据库集群，默认连接参数为：主机localhost、端口5432、用户名为你的系统用户名、无密码、连接串postgresql://localhost（见 docs/de/index.md）；
3. 配置命令行工具：Postgres.app 随包携带psql、createdb、pg_dump、pgbench、postgres等一整套 PostgreSQL 命令行工具以及 PostGIS 的shp2pgsql、raster2pgsql等，使用前需把二进制目录加入$PATH（详见 docs/de/documentation/cli-tools.md）：

sudo mkdir -p /etc/paths.d && echo /Applications/Postgres.app/Contents/Versions/latest/bin | sudo tee /etc/paths.d/postgresapp

完成后重新打开终端，用which psql验证路径是否生效，之后即可直接用psql连接； 4.更新：Postgres.app 2 内置自动更新功能，也可在菜单中手动选择 "Check For Updates…"；若要把数据目录升级到新的 PostgreSQL 大版本，需参考 docs/de/documentation/update.md 中的迁移指引。

如何快速选出适合你的安装包

综合以上信息，可以按下面的思路在下载页中做选择：

• 首次接触 PostgreSQL、想最快跑起来→ 下载"当前版本"（PostgreSQL 18，Universal，123 MB），一份搞定引擎、PostGIS 与常用扩展；
• 需要在本机兼容/对比多个 PostgreSQL 大版本→ 下载"所有受支持版本"聚合包（533 MB），利用独立的var-XX数据目录同时运行 14–18 五个大版本；
• 只需要特定大版本、希望下载更小→ 按需选择 PostgreSQL 17/16/15/14 的单版本包（88–120 MB）；
• 想提前体验 PostgreSQL 19 新特性→ 下载带Pre-release徽标的 19 Beta 包，注意其属于 3alpha 预发布线；
• macOS 低于 10.15→ 前往 docs/de/downloads_legacy.md，按 macOS 版本匹配 v2.1.x 或 Legacy 包，并知晓这些旧包已不再维护。

下载页的版本构成、体积与系统要求会随 docs/_config.yml 更新而变化，本文数据基于当前仓库快照；实际下载时请以站点渲染出的"版本名 + 徽标 + 系统要求 + 体积"卡片为准，并在安装前核对它与你的 macOS 版本是否匹配。

• 数据库
• 桌面应用