客户端概览

非官方测试版翻译

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

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

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

如果您正在使用 React，调用 tRPC API 的最佳方式是使用我们的 React Query 集成。除了类型安全的 API 调用外，它还提供缓存、失效以及加载和错误状态管理。如果您在使用 Next.js 的 /pages 目录，则可以使用我们的 Next.js 集成，它在 React Query 集成的基础上，还添加了服务端渲染（Serverside Rendering）和静态生成（Static Generation）的辅助功能。

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

除了 React 和 Next.js 集成以及 Vanilla Client 外，还有各种社区构建的其他框架集成。请注意，这些集成并非由 tRPC 团队维护。