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

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

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

先说这份文档

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

本来我没打算摊这么大。的时候，先出了 PG 18 的中文文档，后来，我觉得就差不多了。结果这边刚收工，那边 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 了。这事不怪谁。人肉翻译的速度，本来就跟不上上游一年一个大版本的节奏。志愿者用爱发电，爱是会累的。

后来也出现过 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 的文档整体重新校准了一遍。

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

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

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

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

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

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

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

还有几个顺带的东西：

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

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

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

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

整个站基本忠于官网的结构和内容，你熟悉 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，转给身边用 PG 的朋友。

pgsql.cc — PostgreSQL 官方文档中文版 10 到 20，11 个大版本，打开即用，持续更新，没有广告。

数据库老司机

点一个关注 ⭐️，精彩不迷路