参考资料
本篇收拢全系列用到的官方入口和社区资源。遇到配置项含义、版本行为差异、参数默认值这类问题，优先查官方文档，其次看 Wiki 和邮件列表，最后才是搜索引擎里的二手文章。
官方入口
- PostgreSQL 官网：项目主页，下载、文档、社区、新闻的总入口，版本发布公告也在这里。
- PostgreSQL 官方文档：唯一权威口径，参数、SQL 语法、系统视图字段都以这里为准；左上角可以切版本，查旧版本行为很方便。
- PostgreSQL Wiki：社区维护的实践知识库，性能调优、复制、升级、平台适配的经验帖大多在这里。
- 版本支持策略：官方承诺每个大版本从发布起支持 5 年，规划升级周期时按这个算。
- Release Notes：每个版本的变更明细，升级前必看，尤其是「不兼容变更」和「废弃特性」两节。
- 邮件列表：
pgsql-general问用法，pgsql-hackers看开发讨论，pgsql-bugs报缺陷，归档可全文搜索。 - 官方活动与会议：PGConf、PGDay 的时间地点，部分会议有录像和讲义。
文档的版本选择
/docs/current/ 永远指向最新稳定版。生产跑 16 就切到 /docs/16/，别拿 17 的文档对照 16 的实例——参数改名、默认值调整、视图字段增减都可能导致误判。URL 里的版本号直接改就行。
文档分区怎么找
官方文档很长，按问题类型定位能省不少时间：
| 分区 | 内容 | 什么时候看 |
|---|---|---|
| Tutorial | 入门教程 | 第一次接触，跟着走一遍 |
| SQL Language | SQL 语法、数据类型、函数 | 写查询、查函数签名 |
| SQL Commands | 每条命令的完整语法 | CREATE INDEX、ALTER SYSTEM 的选项 |
| Server Administration | 配置、认证、备份、复制、性能 | 运维场景的主战场 |
| Client Interfaces | libpq、ecpg 等 | 排查驱动层问题 |
| Server Programming | 扩展、触发器、存储过程 | 写扩展或自定义函数 |
| Internals | 存储、事务、WAL、优化器 | 理解原理，看第 1 篇时对照 |
| Reference | 系统视图、配置参数、错误码 | 查字段含义和错误码解释 |
几个高频直达页：
- 运行时参数：
postgresql.conf所有参数的官方说明，含默认值和是否需要重启。 - 系统视图：
pg_stat_*、pg_locks的字段定义。 - 错误码：应用里判断
40001、23505这类 SQLSTATE 时查。 - 备份与恢复：PITR、归档、基础备份的完整流程。
生态工具
| 工具 | 用途 | 入口 |
|---|---|---|
| pgAdmin | 图形化管理客户端 | pgadmin.org |
| PgBouncer | 连接池，transaction 模式最常用 | pgbouncer.org |
| Patroni | 基于 DCS 的高可用与自动切换 | patroni.readthedocs.io |
| repmgr | 轻量级复制管理 | repmgr.org |
| pgBackRest | 企业级备份与 PITR | pgbackrest.org |
| pg_repack | 在线消除表膨胀 | reorg.github.io/pg_repack |
| PostGIS | 地理空间扩展 | postgis.net |
| pg_stat_statements | 慢 SQL 统计（自带 contrib） | 官方文档「pg_stat_statements」章节 |
| postgres_exporter | Prometheus 指标导出 | GitHub |
| pgBadger | 日志分析报告 | GitHub |
| pgbench | 内置压测工具 | 官方文档「pgbench」章节 |
| PGXN | 扩展分发网络 | pgxn.org |
这些工具在第 4、5、6 篇里都出现过，装之前先看官方文档的兼容性说明——尤其是 Patroni 和 pgBackRest，对 PostgreSQL 版本有明确要求。
社区与学习资源
- Awesome Postgres：社区维护的资源清单，客户端、扩展、监控、高可用工具按类别收齐，找轮子先逛这里。
- Planet PostgreSQL：核心开发者和 DBA 的博客聚合，新特性解读和踩坑记录质量较高。
- PostgreSQL Weekly：每周一封邮件汇总新闻、文章和工具，适合保持信息更新。
- Stack Overflow 的 postgresql 标签：具体报错和写法问题，搜索命中率很高，提问前先翻已有答案。
- PostgreSQL 官方新闻与公告：版本发布、安全通告、社区动态的官方出口。
- PGXN 扩展索引：按功能找扩展，装之前看维护状态和最近提交时间。
中文资料怎么用
中文博客和翻译文档适合快速建立印象，但涉及参数默认值、版本行为、错误码时，一定回官方文档核对。翻译滞后是常态，尤其是新版本特性——比如 16 的逻辑复制并行 apply、17 的 VACUUM 内存管理改进，中文资料往往还停留在旧版本。
常见问题去哪儿找
带着具体问题查资料，比从头读文档快得多。按这张表定位：
| 问题类型 | 首选入口 | 备注 |
|---|---|---|
| 参数含义、默认值、是否要重启 | 官方文档「Runtime Configuration」 | 每个参数都标了 context |
| 系统视图字段含义 | 官方文档「System Views」 | 字段类型和「仅超级用户可见」都有标注 |
| SQL 报错码 | 官方文档「Error Codes」 | 应用里按 SQLSTATE 做分支 |
| 某个函数怎么用 | 官方文档「Functions and Operators」 | 有完整示例和边界说明 |
| 复制搭不起来 | 官方文档「High Availability」+ Wiki | 先看日志里的具体报错 |
| 性能突然变差 | Wiki 的 Performance 分类 + 邮件列表归档 | 附上 EXPLAIN 和表结构再提问 |
| 升级注意事项 | 目标版本 Release Notes | 重点看不兼容变更 |
| 扩展装不上 | PGXN + 扩展自己的文档 | 先确认和当前大版本兼容 |
| 安全漏洞 | 官方 Security 页面 + 邮件列表公告 | 小版本升级通常就是修漏洞 |
| 驱动/连接池问题 | 对应项目文档 + libpq 章节 | 先排除认证和 SSL 配置 |
提问前做三件事：贴版本（SELECT version()）、贴完整报错、贴相关配置。邮件列表和 Stack Overflow 上没人愿意猜环境。
安全与版本公告
- Security 页面：已披露漏洞和修复版本，收到安全通告后按这里对照自己的小版本。
- Security 邮件列表：漏洞公告会先发到这里，生产环境建议订阅。
- 小版本要跟：16.1、16.2 这种小版本只修 bug 和安全问题，不引入新特性，升级风险低，别攒着不升。
- 大版本别追新：新版本至少等第一个小版本发布、扩展生态跟上之后再上生产。
文档查阅技巧
- URL 直接改版本号：
/docs/current/换成/docs/16/，避免新旧版本参数混淆。 - 用浏览器搜索定位：文档单页很长，
Ctrl+F搜参数名比翻目录快。 - 看「Notes」小节：很多行为差异、平台限制、权限要求都写在正文末尾的 Notes 里，容易漏。
- 对照
pg_settings：文档说默认值是多少，实例上SHOW 参数名或查pg_settings确认实际值，ALTER SYSTEM可能改过。 - 错误信息全文搜索：把报错原文加引号丢进搜索引擎，通常能直接命中邮件列表的讨论。
按阶段的阅读顺序
刚接手 PostgreSQL，按这个顺序建立知识框架：
- 入门：官方 Tutorial + 本系列第 1、2 篇，把进程模型、WAL、安装和 psql 用熟。
- 日常开发：SQL Language 里的数据类型、函数、索引章节，配合第 3 篇的 EXPLAIN 实践。
- 运维：Server Administration 的配置、认证、备份、复制四章，配合第 4、5 篇。
- 排障：系统视图 +
pg_stat_statements文档，配合第 6 篇和命令速查。 - 深入：Internals 里的存储、事务、WAL、优化器章节，理解为什么参数要这么调。
每一层都不需要一次读完，遇到问题带着具体场景去查，印象更深。
版本与兼容性
- 大版本每年一个，小版本按季度发，小版本升级只做 bug 和安全修复，通常可以直接替换二进制。
- 升级大版本要么
pg_upgrade（原地升级，快但要停机），要么逻辑复制/pg_dump（跨版本，慢但可控），两条路都要先读目标版本的 Release Notes。 - 扩展兼容性是升级时最容易忽略的点：PostGIS、pg_repack、pg_stat_statements 都要跟着升，版本不匹配会直接导致启动失败。
- 驱动兼容性：libpq 协议向后兼容，但 SCRAM 认证、
sslmode默认值变化这类细节要确认客户端版本。
别在生产直接试新版本
新大版本发布后，先在测试环境跑一遍完整业务回归，重点验证扩展、备份恢复、复制和连接池。PostgreSQL 的稳定性口碑很好，但「稳定」不等于「零变更」，Release Notes 里的不兼容项都是真实会踩的坑。
本系列相关
- PostgreSQL 核心概念与架构：进程模型、WAL、MVCC，理解后面所有内容的基础。
- PostgreSQL 安装与快速上手：装库、认证、psql、建库建用户。
- Prometheus 核心概念与架构：第 5 篇监控部分的上游知识，指标怎么存、怎么查、怎么告警。
资料不在多，能把官方文档的对应章节翻熟，已经能解决八成问题。剩下的两成，多半在邮件列表的归档和 Wiki 的实践帖里。
资料维护
- 外部链接可能随项目重构失效，打不开时用官网站内搜索或 GitHub 仓库名重新定位。
- 文档版本以
/docs/current/为准，对照生产实例时记得切到对应大版本。 - 扩展类资料优先看项目自己的 README 和 Release Notes，第三方教程往往滞后。
- 本系列正文中的参数和命令均以 PostgreSQL 16 为基线，跨版本使用时先核对语法和行为差异。