TypeScript Academy · 课时

使用 Zod 进行运行时验证

Q: 「使用 Zod 进行运行时验证」这节课中我会学到什么？

使用 Zod 模式验证并推断 API 响应类型 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

使用 Zod 模式验证并推断 API 响应类型

第 2 / 4 课13 个步骤

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

欢迎

Zod 是一个以 TypeScript 为先的 Schema 验证库，可以从 Schema 推断类型，同时提供运行时验证和编译时类型。

安装 Zod

在您的项目中安装 Zod。

npm install zod

基本 Schema

定义 Schema 并推断其 TypeScript 类型。

import { z } from 'zod';
const UserSchema = z.object({
  id: z.number(),
  name: z.string(),
  email: z.string().email(),
});
type User = z.infer<typeof UserSchema>;

解析数据

使用 schema.parse() 进行验证。验证失败时它会抛出错误。

const user = UserSchema.parse({ id: 1, name: 'Alice', email: 'a@b.com' });
// user is typed as User

安全解析

使用 safeParse() 将错误作为值返回，而不是抛出错误。

const result = UserSchema.safeParse(unknownData);
if (result.success) {
  console.log(result.data); // User
} else {
  console.log(result.error.issues);
}

数组和对象 Schema

使用 z.array 和 z.object 组合复杂的 Schema。

const UsersSchema = z.array(UserSchema);
const CreateUserSchema = UserSchema.omit({ id: true });

可选与可空

将字段标记为可选或可空。

const Schema = z.object({
  name: z.string(),
  bio: z.string().optional(),   // string | undefined
  avatar: z.string().nullable(), // string | null
});

枚举与联合类型

验证枚举值和联合类型。

const StatusSchema = z.enum(['active', 'inactive', 'banned']);
const InputSchema = z.string().or(z.number());

转换

转换解析后的值。

const PriceSchema = z.string().transform(s => parseFloat(s));

API 路由中的 Zod

在 Express/Next.js API 路由中验证请求体。

app.post('/users', async (req, res) => {
  const result = CreateUserSchema.safeParse(req.body);
  if (!result.success) return res.status(400).json(result.error);
  const user = await db.create(result.data); // typed!
  res.json(user);
});

自定义验证器

向 Schema 添加自定义细化规则。

const PasswordSchema = z.string().min(8).refine(
  s => /[A-Z]/.test(s), { message: 'Need uppercase' }
);

快速检查

Zod 提供哪个方法，可以在验证失败时不抛出错误而验证数据？

在交互式课程中回答

回顾

使用 Zod 进行运行时验证：您已经掌握了关键概念和模式。

免费开始

用 AI 导师学习 TypeScript — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 101
课程: 352

免费开始学习查看完整课程

常见问题解答

「使用 Zod 进行运行时验证」课时是免费的吗？

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

「使用 Zod 进行运行时验证」这节课中我会学到什么？

使用 Zod 模式验证并推断 API 响应类型你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

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

「使用 Zod 进行运行时验证」课时需要多长时间？

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

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

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

此课程中的所有课时

← 返回 TypeScript Academy