0Pricing
TypeScript Academy · 课时

类型安全的 tRPC 客户端概览

了解 tRPC 如何实现端到端类型安全

类型安全的 tRPC 客户端概览 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 4 节课。

欢迎

tRPC 可以在服务端与客户端之间实现端到端的 TypeScript 类型安全，而无需代码生成。

什么是 tRPC

tRPC 允许您从客户端调用服务端函数，并获得完整的类型安全保障。不需要 OpenAPI 规范或代码生成，只需使用 TypeScript。

服务端路由器定义

使用 tRPC 路由器在服务端定义带类型的过程。
import { initTRPC } from '@trpc/server';
const t = initTRPC.create();
const appRouter = t.router({
  getUser: t.procedure.input(z.number()).query(({ input }) => db.getUser(input)),
});

类型推断

导出路由器类型，供客户端使用。
export type AppRouter = typeof appRouter;

客户端设置

使用服务端路由器类型创建带类型的 tRPC 客户端。
import { createTRPCProxyClient, httpBatchLink } from '@trpc/client';
const trpc = createTRPCProxyClient<AppRouter>({
  links: [httpBatchLink({ url: '/api/trpc' })],
});

带类型的客户端调用

从客户端调用服务端过程，并获得完整的自动补全。
const user = await trpc.getUser.query(1);
// user is typed as the return type of getUser

使用 Zod 验证输入

将 Zod Schema 用作 tRPC 输入验证器。
t.procedure.input(z.object({ name: z.string(), email: z.string().email() })).mutation(...)

变更

为修改数据的操作定义变更。
const router = t.router({
  createUser: t.procedure.input(CreateUserSchema).mutation(({ input }) => db.create(input)),
});

React Query 集成

tRPC 与 React Query 集成后，可以在获取数据时获得完整的类型推断。
const { data: user } = trpc.getUser.useQuery(1);
// data is typed automatically

tRPC 中的错误处理

tRPC 提供带类型的错误。
import { TRPCError } from '@trpc/server';
if (!user) throw new TRPCError({ code: 'NOT_FOUND', message: 'User not found' });

tRPC、REST 与 GraphQL

tRPC 非常适合全栈 TypeScript 项目。REST 和 GraphQL 更适合公共 API 或跨语言 API。

快速检查

tRPC 如何实现服务端与客户端之间的类型安全？

回顾

类型安全的 tRPC 客户端概览：您已经掌握了关键概念和模式。

常见问题解答

「类型安全的 tRPC 客户端概览」课时是免费的吗？

是的 — 「类型安全的 tRPC 客户端概览」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 4 节课。

「类型安全的 tRPC 客户端概览」这节课中我会学到什么？

了解 tRPC 如何实现端到端类型安全 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。

「类型安全的 tRPC 客户端概览」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗？

能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 使用泛型包装器为 Fetch 响应添加类型
  2. 使用 Zod 进行运行时验证
  3. OpenAPI 代码生成：自动生成类型
  4. 类型安全的 tRPC 客户端概览
← 返回 TypeScript Academy