#PostgreSQL

本文覆盖 PostgreSQL 的连接与工具、数据类型、表设计与约束、查询、索引与执行计划、事务与并发、权限、备份恢复与常用配置，可作为日常开发与运维的参考。

• 环境：PostgreSQL 16（大部分语法 13+ 通用）
• 客户端：psql、任意支持 PG 的 GUI（DBeaver、DataGrip）或 Node 驱动 pg

本文讲在 Node.js 里如何使用 PostgreSQL：驱动选型、连接池、参数化查询、事务、类型映射、错误处理与生产实践。示例基于 pg（node-postgres），同时给出 ORM 的选型建议。

• 环境：Node.js 20+、PostgreSQL 16、pg 8.x
• 示例默认使用 CommonJS，ESM 写法在文末说明

我做 Nexus，最初是想练习块编辑器和实时协同，后来它逐渐变成一个面向小团队的自托管协作文档工作台：从块编辑、多人协同、工作区权限，一路长到匿名分享、Markdown 导入导出、后台任务、可观测性和 AI 工作台。回头看，功能清单不是最值得分享的部分；真正让我成长的，是每加一层能力，都得重新回答“数据谁说了算、失败时怎么办、权限在哪里拦”。