AI写PostgreSQL代码，总在生产环境翻车？这个开源工具让AI写出真正靠谱的SQL

AI 写 Postgres 代码，看着能跑，上线就埋雷。

不是 AI 不聪明，是它学 SQL 的时候把 PostgreSQL、MySQL、SQLite、Oracle 全混一块了。出来的代码什么问题都有：SERIAL 和 UUID 混用、VARCHAR 长度拍脑袋、TIMESTAMP 和 TIMESTAMPTZ 不分、该加的索引没加、不该建的索引乱建。

你以为测试通过了就没事？数据库的坑最阴。表小的时候看不出来，等数据量上来——慢查询、锁竞争、迁移改不动，一锅粥。

Timescale 出了一个开源工具叫 pg-aiguide，专门治这个。

它怎么工作的

pg-aiguide 其实是给 AI 编程助手装了一本PostgreSQL 专用教材，不是通用 SQL，是真正的 Postgres 最佳实践。它有两层能力：

• 语义搜索：对 PostgreSQL 官方文档（14~18版本）做语义检索，AI 写 SQL 的时候能查到对应版本的最新语法，而不是拿过时的用法堆。
• 最佳实践技能包（Skills）：Timescale 官方整理的 Postgres 专项指南——Schema 设计、索引策略、数据类型、命名规范、性能调优，全是生产环境验证过的经验，AI 直接内化到输出里。

官方还做了实测对比：同一个”设计电商数据库”的 prompt，关掉 pg-aiguide 和开启之后，生成结果差距明显——4 倍以上的约束条件、55% 以上的索引覆盖（含部分索引和表达式索引），以及 PG17 推荐的新写法（GENERATED ALWAYS AS IDENTITY）。

支持哪些 AI 工具

这是一大亮点——不挑工具。

• Claude Code：/plugin marketplace add timescale/pg-aiguide 然后 /plugin install pg-aiguide
• Cursor、Windsurf、VS Code：加 MCP server 地址 https://mcp.tigerdata.com/docs
• Codex CLI、gemini CLI：同样接 MCP 协议
• 直接用 npx 安装技能包：npx skills add timescale/pg-aiguide --skill postgres

一句话：你在用什么 AI 编程工具，基本都能用。

为什么值得装

数据库代码有个特点——上线之后再改，成本极高。应用代码可以重构，数据库的字段类型、约束、索引迁移是要命的。

pg-aiguide 的思路是：在 AI 生成的源头就把关，不要等上线了再打补丁。让 AI 写 SQL 的第一遍就带上 PostgreSQL 的判断力，这比后期 debug 便宜太多。

而且它是 Timescale 官方出品——这家公司做 PostgreSQL 扩展生态（TimescaleDB）好几年了，东西相对靠谱。

一句话总结

如果你用任何 AI 编程工具写 SQL，pg-aiguide 是目前最值得装的 Postgres 专项外挂——让你的 AI 输出的代码，从”能跑”变成”真的对”。

GitHub：https://github.com/timescale/pg-aiguide（⭐ 1.7K，Apache-2.0 开源）

GitHub: https://github.com/timescale/pg-aiguide