Kysely 和 Knex.js 对比：查询构造器的新旧对话
Knex.js 是 2012 年以来的查询构造器老兵，Kysely 是 TypeScript 原生设计的挑战者。本文从查询构建、事务、迁移、调试体验全面对比。
TypeScript 新项目选 Kysely（字段级类型安全、无引擎依赖）；维护中的 Knex 项目继续用（成熟稳定、数据库覆盖面广）。两者都是"SQL 优先"哲学，差异在类型安全的深度。
基本盘
Knex.js（2012）：跨数据库查询构造器的常青树，PostgreSQL/MySQL/SQLite/Oracle/MSSQL 通吃，生态成熟。
Kysely（2021）：TypeScript 原生设计的查询构造器——目标是把 SQL 的类型错误从"凌晨三点的生产事故"提前到编译期。
安装与设置
Knex 装驱动即可开工；Kysely 需要定义表结构接口（或用 kysely-codegen 从现有库生成）。前者起步快，后者起步多一份类型契约——这份契约是后续所有收益的根基。
查询构建体验
// Knex：运行时才能发现 'emial' 拼错了
const users = await knex('users').select('name', 'emial');
// Kysely：拼错的字段在编辑器里就红了
const users = await db.selectFrom('users').select(['name', 'emial']);
// ~~~~~ 编译错误：不存在该列
SQL 表达能力两者相当（join、子查询、CTE、窗口函数都支持），Kysely 的 expressionBuilder 在复杂表达式上类型更精确。
事务管理
API 结构几乎相同（回调式事务，抛错回滚）。Kysely 的事务对象类型与主实例一致，IDE 补全完整；Knex 事务靠文档记忆。
迁移支持
- Knex：内置迁移 CLI 成熟（migrate:make/latest/rollback），社区资料厚；
- Kysely：Migrator 提供机制（执行/回滚），文件组织自定义——更自由也更裸。
重度依赖迁移工具链的团队，Knex 的"开箱完整"仍是优势。
原生 SQL 与调试
- Knex 的
knex.raw()与toSQL()调试链路成熟； - Kysely 的
sql模板带类型标注，compile()查看生成 SQL 同样方便——配合插件可输出带参数的完整 SQL。
决策
| 场景 | 推荐 |
|---|---|
| TS 新项目 | Kysely |
| JS 项目 / 类型无关 | Knex |
| Oracle/MSSQL 等冷门库 | Knex（驱动覆盖广） |
| Serverless/边缘 | Kysely（纯 TS 无原生依赖、冷启动快） |
用实际查询验证数据访问方案
Kysely 和 Knex.js 对比的选择最终要落到查询次数、SQL 耗时与连接占用。应用接入观测云 APM 时，先核对 SDK 是否支持实际使用的数据库驱动，不能因为使用了某个 ORM 就假设全部查询自动可见。未覆盖的查询可手动插桩；PostgreSQL 等服务端数据库另配实例采集。SQL 和绑定参数上报前须脱敏，再按相同接口比较 N+1 查询与慢查询的变化。
接入文档：Node.js APM 接入 · PostgreSQL 采集 · 日志采集。
常见问题（FAQ）
Q：Kysely 的性能如何？
纯 JS 实现无额外引擎进程，开销低于 Prisma 类 ORM，与 Knex 同量级。生成的 SQL 就是你写的形状，无黑盒。
Q：Knex 能补类型吗？
有社区类型包（knex-types 等），但推导深度远不及 Kysely 的原生设计——类型安全是架构层差异，补丁补不齐。
Q：从 Knex 迁到 Kysely 的路径？
并行期可行：同一数据库连接两者共存，新查询用 Kysely 写，存量 Knex 查询随重构替换。表结构类型用 kysely-codegen 生成起步。
参考文档
本文依据公开文档整理，示例需按项目依赖版本验证；不将文档中的性能描述视为本项目实测结果。
