首页 › 效率提升 › 改一列就报错?Reylo 让 SQL 自带类型

改一列就报错?Reylo 让 SQL 自带类型

📅 2026/11/16 👁 阅读 32 🔗 工具访问 12 次 📂 效率提升
改一列就报错?Reylo 让 SQL 自带类型

工具地址

https://github.com/colinhacks/reylo

🚀 访问工具

写查询最烦的往往不是 SQL 本身,而是结果类型得人手描一遍:表里加了一列忘了改接口,编译时不报错,上线后某个字段突然变成空;或者干脆上一套代码生成器,每次改完查询都要等它跑一遍,仓库里平白多出一片生成文件,还得配个常驻监听盯着。想让类型跟着 SQL 自己变,又不想往工程里再塞一层工具,过去总得像这样二选一。

Reylo 官网首页,标题与代码演示同屏

Reylo 是 10 月 21 日新建的开源仓库,到 11 月 16 日有 1594 颗星,用 Rust 写成,MIT 许可,当前版本 v0.7.0。做法很直接:把 .sql 文件当成模块直接 import,类型由开发库当场给出。它让数据库把查询 prepare 一遍但不执行,读回每一列与每个参数的类型,再补上可空性、行数、枚举与 JSON 形状:主键命中或 limit 1 返回「一行或空」,无 group by 的聚合返回「恰好一行」,没有 returning 的写入返回 void,其余返回数组。列名拼错会在类型检查时直接报错。整个过程不生成文件、不需要监听进程。

说明页演示静帧,编辑器里 import 一个 .sql 文件,类型随查询内容变化

支撑这件事的是 TypeScript 7.1 引入的内容映射能力,目前还在测试阶段:把某种扩展名交给一个包去定义静态类型,直接接进编译流程。于是类型不是靠猜语法猜出来的,而是问数据库要来的,数据库支持的任意语法、函数与运算符都能照写。配置也就三步:装包与对应的测试版编译器,在 tsconfig 里挂上内容映射,用类型检查命令跑一遍,再把连接串指向开发库。

演示后半段静帧,SQL 里多取一列,编辑器里的类型跟着改写

第一,它挪走的是「同步」这件事。类型来自当前开发库的 schema,改表之后下一次类型检查就能对上,不需要再维护一份手写接口,也没有生成文件和常驻监听要照顾。代价同样清楚:必须有一个能连上的开发库,离线或没起数据库时,这套推断就无从谈起。

第二,边界得如实说。当前要求测试版的 TypeScript 7.1 与 Node 24 以上,DuckDB 支持仍标着预览;它是让数据库帮你 prepare,不是替你执行查询,所以运行时还得自己带驱动,pg、postgres.js、mysql2、better-sqlite3 这类都行,Postgres、MySQL、SQLite、DuckDB 四类库各有细节。想直接拿它当查询构造器用,方向就错了。

第三,可核对性做得比口号实在。查询对象除 run 之外还有同步执行、试运行、参数绑定与原始语句等接口,每次执行都会发到运行时的追踪通道,便于接日志;项目还专门写了从另一套 ORM 迁过来的说明。把接口面和迁移路径摊开,比只喊一句「类型安全」更容易判断能不能进项目。

推断规则、四类数据库与三项门槛一图看清

有个细节挺克制:说明页把「哪些情况返回一行、哪些返回数组」列成一张小表,连没有 returning 的写入返回 void 都写进去了。结果行数这种最容易在接口层写错的地方,被当成一等公民讲明白,比多展示几个炫酷示例更省后期的排查时间。

你改表结构时最在意类型能不能立刻跟着变,还是更怕工程里多一套生成文件和常驻监听?

💬 评论区 (0 条评论)

暂无评论,快来发表第一条评论吧!

📤 分享这篇文章

📌 相关推荐

微信扫码分享

打开微信扫一扫