在使用 Zod 进行表单验证时，若需校验 password 与 confirmPassword 字段是否一致，必须将跨字段校验逻辑放在整个对象 schema 的顶层 .refine() 中，而非单个字段的 refine 内部——否则会因作用域限制导致字段访问错误。
在使用 zod 进行表单验证时，若需校验 password 与 confirmpassword 字段是否一致，必须将跨字段校验逻辑放在整个对象 schema 的顶层 .refine() 中，而非单个字段的 refine 内部——否则会因作用域限制导致字段访问错误。
Zod 是一个运行时类型安全的 TypeScript 验证库，其设计强调不可变性和函数式链式调用。关键点在于：每个字段的 .refine() 回调只接收该字段的值（如 string），无法访问对象其他属性。因此，当你在 confirmPassword: z.string().refine(...) 中尝试访问 data.password 时，TypeScript 正确报错：
Property 'password' does not exist on type 'string'.
✅ 正确做法是：先定义基础对象结构，再对整个对象进行联合校验。
以下是完整、可直接使用的示例代码：
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()在对象层级调用时，参数data类型即为ResetPassword，可安全访问所有字段； -
path选项用于指定错误归属字段（影响前端错误提示定位），推荐显式设置； - 如需更严格的密码规则（如最小长度、大小写字母、数字等），可在对应字段上叠加
.regex()或自定义.refine()。
总结：Zod 的字段级验证（.refine）仅作用于当前字段值；跨字段逻辑（如密码一致性、日期范围、条件依赖等）必须通过对象 schema 的顶层 .refine() 实现——这是 Zod 类型安全与作用域隔离的设计使然，也是编写健壮验证逻辑的关键原则。
