技能介绍

它解决什么问题

写 SQL 的人大概都有过这种体验：手边开着 psql，却记不清某张表里到底叫 created_at 还是 create_time；一个多行查询写到一半，光标跳来跳去，改错一个括号就得整体重来。pgcli 要解决的就是这类「和编辑器体验脱节」的痛点：把自动补全、语法高亮和舒适的多行编辑能力，直接做进交互式 PostgreSQL 客户端里，让写查询的过程更接近写代码。

它是怎么工作的

核心能力可以拆成三块：

上下文感知的自动补全：它不只是对表名做前缀匹配，还会读取当前会话的 schema 信息，在你输入表名、字段名、函数名甚至别名时给出候选。输入 SELECT * FROM ord，它会按当前数据库里真实的表结构来补全。
语法高亮：关键字、字符串、数字和注释有各自的颜色，多行查询里一眼就能看清结构，跑错方向时定位问题更快。
多行查询编辑：支持跨行输入和编辑语句，不必把一条复杂查询硬塞进单行；配合历史记录，之前写过的语句可以直接翻出来复用。

它源自开源项目 dbcli，属于 pgcli 上游工具本身的定位，即把数据库探索和查询编写的交互门槛降低，而不是再造一个图形化客户端。

适用边界与注意点

适合的场景是日常连库排查、写复杂 SQL、探索陌生 schema；如果你已经有一套成熟的数据库迁移或 CI 流程，它不会替代这些工具，只是替代手敲 psql 的那一步。另外，补全的准确性取决于它是否能连上当前数据库并读到最新的元数据，换了库或权限受限时，候选结果会相应变化。它本质上是交互式客户端，不适合当作脚本化的批处理执行器——那种场景还是用常规的命令行工具更直接。