使用Zod时类型推断错误：email被推断为string|false

你遇到的问题出在validator.normalizeEmail的类型定义上——哪怕Zod已经通过z.string().email()确保输入是合法邮箱，这个函数的类型还是标注为返回string | false，所以TypeScript会把transform后的结果也识别成联合类型。

实际上，经过Zod的邮箱格式验证后，normalizeEmail处理合法邮箱时几乎不会返回false，但类型定义的保守性导致了这个提示。解决方法有两种：

1. 直接类型断言 #

在transform里把结果断言为string，因为我们已经通过前置验证确保了输入合法，这个断言是安全的：

import { z } from "zod";
import validator from "validator";

const email = (maxChar: number) =>
  z
    .string()
    .max(maxChar)
    .email()
    .transform((value) => validator.normalizeEmail(value) as string);

2. 用Zod refine兜底验证 #

如果想更严谨，可以加一层refine确保结果不是false，再做断言：

import { z } from "zod";
import validator from "validator";

const email = (maxChar: number) =>
  z
    .string()
    .max(maxChar)
    .email()
    .transform((value) => validator.normalizeEmail(value))
    .refine((result) => result !== false, {
      message: "邮箱标准化失败"
    })
    .transform((result) => result as string);

本质上，这是validator库类型定义的保守性和Zod验证逻辑之间的类型不匹配问题，通过断言或者额外验证就能让TypeScript正确识别最终的string类型。

内容的提问来源于stack exchange，提问作者Aslan