# PG 中文文档发布：11 个大版本，一个不落

LLMS 索引： [llms.txt](/llms.txt)

---

今日 **[pgsql.cc](https://pgsql.cc/)** 上线，包含 11 个 PG 大版本的中文文档、美化后的官网，以及更好的全文检索，彻底补上了 PostgreSQL 中文生态的文档短板。

![pgsql.cc 中文站首页](homepage.webp)

不只是手册。整个 postgresql.org 官网——首页、关于、新闻、活动、下载、社区、开发者、支持——全部汉化。顺手还把官网的样式重做了一遍，把那个饱受诟病的全文检索也换掉了。

![PostgreSQL 中文文档检索结果与文档预览](doc-search.webp)

---

## 先说这份文档

在线的中文手册一共覆盖 11 个大版本：从 PG 10 一路到 PG 19 Beta，外加一个 PG 20 devel 的开发快照。

本来我没打算摊这么大。[**三月份上线 pg.center**](../pg-center/) 的时候，先出了 PG 18 的中文文档，后来 [**把 14 到 17 补齐，五个活跃版本齐活**](../pgdoc-cn/)，我觉得就差不多了。结果这边刚收工，那边 19 就进了 Beta 3，devel 分支也滚到了 20，一下又多出来两个大版本。我一想，一不做二不休，干脆把 10 以来那几个已经 EOL 的老版本也一并翻了。

为什么要翻已经没人维护的版本？因为真的有人在用。国内跑 PG 11、PG 12 的存量系统一抓一大把，升级排期排到明年也是常事。文档要是只覆盖维护期内的版本，这批人还是只能去啃英文。

---

## 这个坑为什么空着

其实不是没人干过。PG 中文社区组织过一轮很长的接力翻译，从最早 laser 翻的 8.2.3 开始，9.3、9.4、9.5、9.6，一版一版往后传，一直做到 15。这是实打实的功夫。一个大版本的手册上千页，靠一群人在业余时间抠着翻、互相校对，一版磨一两年是常态。参与过的志愿者都值得敬意。

但接力棒到 15 就掉在地上了。16、17 的分支还挂在仓库里“校对中”，一直没有正式发布。而上游这边，18 已经发布快一年，19 都到 Beta 3 了。这事不怪谁。人肉翻译的速度，本来就跟不上上游一年一个大版本的节奏。志愿者用爱发电，爱是会累的。

![Google 上的 PostgreSQL 中文文档搜索结果](search-results.webp)

后来也出现过 18.3 中文文档，不过感觉像是机翻的，翻完也没人管——18.3 就撂那儿了，到今天快半年没动过。上游 8 月 13 日刚发布了 18.6、17.11、16.15、15.19、14.24 五个小版本，顺手修了 28 个安全漏洞，19 Beta 3 也一并出来了，那边还停在原地。

更劝退的是，有的网站页面上还挂着大幅弹窗广告。你正查着 `pg_hba.conf` 怎么配，旁边弹出来一个“XX 数据库限时免费试用”，实在不忍直视。

---

## 这次是怎么翻的

翻译和校对是真烧 Token。这一轮下来，我整整烧掉了 4 个 20x Pro 订阅的额度。

但光有 Token 还不够。翻译这件事是有流程的，最关键的一环是**术语表**——一份权威的、全文统一的 PostgreSQL 术语对照表，以及这些术语在不同语境下的例外处理。哪些词固定怎么译，哪些词在特定章节里必须破例，这部分没有捷径，只能一条条仔细校对。

模型这边也有代差。之前那一版用的大概是 Codex 5.3 这个级别，效果只能说还不错。这次换 Astra 来翻，就基本没什么可挑的了——译得肯定比一般的专家好得多，唯一需要人盯着的就是术语的准确性。所以这次的做法是：用 Codex、Fable 5.1 和 Astra 6 三方交叉校对，加上我自己人工过一遍，校准出一份完整的 PostgreSQL 术语表和例外豁免清单，再拿这份术语表把 PG 14 到 18 的文档整体重新校准了一遍。

![PostgreSQL 翻译术语表与校订记录](glossary.webp)

真正麻烦的是跨版本一致性。11 个大版本，绝大部分内容是共通的，理论上只需要翻变化的那部分。但这里有个坑：同一句英文出现在 11 个版本里，如果原文一模一样，中文也必须一模一样，不能翻十遍出十个样子。你在 PG 14 的手册里看到一个说法，跳到 PG 18 变了个措辞，那这份文档就废了。所以工作流必须保证：每一次翻译，都在所有大版本之间完成对齐。

![翻译与校对消耗的 AI 订阅额度](token-usage.webp)

烧了两天，东西出来了。我自己过了一遍，还算满意。当然，这么大的体量，肯定有翻得别扭甚至翻拧了的地方。你要是遇到任何问题，直接提给我就行——发邮件，或者在 GitHub 上开个 issue，都可以。改起来很快。

这也是它跟机翻站最大的区别：那边是发完就不管了，这边是要跟着上游一直滚下去的。18.7 出来，这边就更新；19 正式发布，这边就跟上。每一个小版本出来，我们都会第一时间跟进。

---

## 顺手干的第二件事：把官网也修了修

PG 官网几年前是美化过一版的，但你现在打开，还是有一股浓浓的“十几年前的老登古董项目”味儿——它当然确实是个三十年的老项目，这没什么好回避的。可现在 Astra、Fable 满地走，人均前端大手子，网站做成这样，多少还是有点说不过去，对吧？

![PostgreSQL 英文官网首页](upstream.webp)

所以我顺手给它美化了一版。中文排版也重新调过——原站的字体、行距、代码块都是按英文设计的，中文读起来并不舒服。至于社区那边接不接受，我可以往上提，提了以后收不收就是另一回事了。

![pgsql.cc 与 PostgreSQL 官网的页面对比](site-comparison.webp)

另一个老被人吐槽的地方是全文检索。有意思的是，PG 官网的搜索用的就是 PG 自己的全文检索，功能没问题，但呈现效果实在太难看了。这次也一并优化掉了：现在直接在搜索栏里就能方便地检索 PG 文档和扩展，站内按 `/` 就能唤起，解决了我自己日用的大问题。

![按斜杠键唤起的站内搜索面板](quick-search.webp)

还有几个顺带的东西：

**URL 一一对应。** 把地址栏里的 `www.postgresql.org` 换成 `pgsql.cc`，就是对应的中文页面。搜索引擎给你甩过来一个英文文档链接，改个域名直接看中文版。

**一键回原文。** 每个页面右上角留了个按钮，能直接跳到 postgresql.org 的对应英文页，对翻译有疑问的时候随时能对照。

**生态组件的中文文档。** Patroni、PgBouncer、pgBackRest、PostGIS、TimescaleDB、Citus 这些常用组件的中文文档也翻好了，链接都挂在文档页里，不用满世界找。

![PostgreSQL 生态组件的中文文档入口](ecosystem-docs.webp)

**PG 扩展目录。** 扩展生态那套东西也接进来了，同样是中文。

![PostgreSQL 中文扩展目录](extensions.webp)

整个站基本忠于官网的结构和内容，你熟悉 postgresql.org 的导航逻辑，切过来几乎零学习成本。区别就是：中文，样式更好看，检索更好用，外加 11 个大版本的完整手册。

---

## 关于域名

三月份上线的时候用的是 pg.center，这次换到 pgsql.cc，原因很实在：`.center` 在国内备不了案，工信部认可的域名后缀清单里压根没有它。域名再好记，备不了案，在国内就进不了正常渠道。

`pgsql.cc` 是我早年囤的域名，能备案，名字也直白：PGSQL + CC，China / Chinese Community。老域名不会关。以后两边分工：**pg.center** 往面向全球的多语言 PG 知识图谱信息站点方向走，**pgsql.cc** 专心做中文文档、官网镜像与社区信息站。

---

## 几条边界

**与 PGDG 无隶属关系。** 站点上写得明明白白：由 Pigsty 团队维护。原文版权属于 PostgreSQL 全球开发组，中文翻译遵循同样的开放许可。这是别人的东西，我只是把它搬进中文世界，该说清楚的地方一个字都不含糊。老冯也不会假装这是 PGDG 社区的站点，所以特意用大横幅标记出来。

**不挂广告。** 最多角落里留一个“由 Pigsty 项目组维护”的文本链接，仅此而已。

**欢迎共建。** 术语怎么定、哪句翻错了、哪个页面漏了，都可以提。

---

## 最后

文档是一个技术生态的地基。地基不牢，地动山摇。

过去这些年，中文 PG 用户手里最好的参考资料，要么是几年前的老翻译，要么是搜出来的二手博客，要么是让大模型现编一段——在 AI 时代，这个问题又会被进一步放大：大模型的中文语料，恰恰又来自那些参差不齐的二手博客。这是个闭环，而且是个死循环。

现在，至少我们有一份干净、完整、有人（AI）持续维护的 PostgreSQL 中文文档了——这让我觉得，这些 Token 花得确实很有意义。

**收藏 [pgsql.cc](https://pgsql.cc/)**，转给身边用 PG 的朋友。

> **[pgsql.cc](https://pgsql.cc/)** —— PostgreSQL 官方文档中文版，10 到 20，11 个大版本，打开即用，持续更新，没有广告。