tRPC(TypeScript 端到端类型安全)

tRPC 是一个面向 TypeScript 全栈开发的远程过程调用(RPC)框架,核心目标是实现前后端之间的端到端类型安全。它让前端在调用后端接口时,能够像调用本地函数一样获得完整的类型提示与编译期检查,而不必手动维护接口类型定义。

概述

在传统前后端分离开发中,接口的参数和返回值类型往往需要在两端各写一遍,容易出现不一致。tRPC 的思路是让后端用 TypeScript 定义一组过程(procedure),前端直接导入这些过程的类型,从而由编译器保证调用方式与后端定义完全匹配。整个过程无需生成代码,也不需要像 GraphQL 那样编写单独的模式文件。

核心特点

• 端到端类型安全:后端的输入输出类型自动传递到前端,改动后端会立即在前端暴露类型错误。
• 无需代码生成:直接依靠 TypeScript 类型推断,省去额外的模式与生成步骤。
• 输入校验:可与校验库配合,在运行时验证请求参数。
• 框架集成:与 Next.js、React Query 等常见前端方案配合良好。

应用场景

tRPC 特别适合前后端都使用 TypeScript、且部署在同一代码仓库(monorepo)中的全栈项目,如基于 Next.js 的中小型应用。它能显著减少接口层的样板代码,让团队专注于业务逻辑。

常见问题

问:tRPC 和 GraphQL 有什么区别?答:GraphQL 是语言无关的查询规范,前后端可用不同语言,需定义模式;tRPC 只服务于 TypeScript 全栈场景,靠类型推断而非模式实现类型共享,适用面更窄但集成更轻。

问:前后端不在同一仓库能用吗?答:tRPC 的类型共享依赖前端能够导入后端类型,因此最适合同仓库的全栈项目;跨仓库时需要额外发布类型包,体验会打折扣。