在使用 Zod 进行表单验证时，需在对象级（而非字段级）调用 .refine() 才能访问全部字段（如 password 和 confirmPassword），否则会因作用域限制导致类型错误。
在使用 zod 进行表单验证时，需在对象级（而非字段级）调用 `.refine()` 才能访问全部字段（如 `password` 和 `confirmpassword`），否则会因作用域限制导致类型错误。
Zod 是一个运行时类型安全的 TypeScript 验证库，其设计强调不可变性与链式调用。当需要校验多个字段之间的逻辑关系（例如密码匹配），必须将 .refine() 应用于整个 z.object() 实例，而非单个字段——因为字段级 refine 的回调函数只接收该字段的值（类型为 string），自然无法访问 data.password 等其他属性。
以下是正确的实现方式：
import { z, ZodType } from 'zod';
export type ResetPassword = {
password: string;
confirmPassword: string;
};
export const resetPasswordSchema: ZodType<ResetPassword> = z
.object({
password: z.string().min(1, 'Password is required'),
confirmPassword: z.string().min(1, 'Confirm password is required'),
})
.refine((data) => data.password === data.confirmPassword, {
message: "Passwords don't match",
path: ['confirmPassword'], // 错误将精准定位到 confirmPassword 字段
});✅ 关键改进说明：
- 使用
.min(1, ...)替代手动refine((v) => v !== '')，更简洁且内置空字符串、空格等边界处理； - 将
.refine()移至z.object(...)之后，此时data类型为ResetPassword，可安全访问所有字段； -
path: ['confirmPassword']确保错误信息绑定到对应表单项，便于前端高亮提示。
⚠️ 注意事项：
- 不要在单个字段上尝试跨字段比较（如
z.string().refine(...)中访问data.password），这会导致 TypeScript 类型报错和运行时undefined； - 若需更复杂的交叉验证（如密码强度 + 匹配双重校验），仍应统一在对象级
.refine()中组合逻辑； - 启用
z.object().strict()可防止意外传入多余字段，增强数据契约安全性。
通过这种结构化校验方式，你既能保障类型安全，又能提供清晰、可定位的用户反馈，是构建健壮表单验证流程的最佳实践。
