客户端概览

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

虽然可以通过普通 HTTP 请求调用 tRPC API（就像调用其他 REST API 那样），但若要充分利用 tRPC 的类型安全特性，您需要一个客户端。

客户端知晓您的 API 中可用的所有过程（procedures）及其输入和输出。它会利用这些信息，在您进行查询（queries）和变更（mutations）时提供自动补全功能，正确标注返回数据的类型，并在您编写的请求与后端结构不匹配时显示错误。

如果您正在使用 React，推荐通过我们的 TanStack React Query 集成 来调用 tRPC API。该方案不仅提供类型安全的 API 调用，还支持缓存、失效机制以及加载状态和错误状态管理。若您在使用带 /pages 目录的 Next.js，则可选用我们的 Next.js 集成，该集成提供了服务端渲染（SSR）和静态生成（SSG）的辅助工具。

如需从其他服务器或我们尚未提供集成的前端框架调用 tRPC API，您可以使用 Vanilla 客户端。

除上述 React、Next.js 集成和 Vanilla 客户端外，还有多种面向其他框架的社区构建集成。请注意这些集成不由 tRPC 官方团队维护。