Zod 本身不提供原生的 alphanumeric 校验方法，但可通过 z.custom() 构建类型安全、可复用的自定义 schema，结合正则高效完成校验，同时保持 Zod 的错误处理与类型推导能力。
zod 本身不提供原生的 alphanumeric 校验方法，但可通过 `z.custom()` 构建类型安全、可复用的自定义 schema，结合正则高效完成校验，同时保持 zod 的错误处理与类型推导能力。
Zod 的设计哲学强调“显式优于隐式”，因此并未内置如 alphanumeric() 这类语义化方法（对比 Joi 或 Validator.js）。但其强大的 z.custom() API 允许开发者在不脱离 Zod 类型系统前提下，灵活封装业务校验逻辑。
以下是一个健壮、可复用的 alphanumeric 自定义 schema 示例：
import { z } from 'zod';
const alphanumeric = z.custom<string>(
(val) => typeof val === 'string' && /^[a-zA-Z0-9]+$/.test(val),
{
message: 'Must contain only letters and digits',
}
);
// 类型自动推导：string
type Alphanumeric = z.infer<typeof alphanumeric>;
// 使用示例
const result1 = alphanumeric.safeParse('abc123'); // ✅ success: true
const result2 = alphanumeric.safeParse('ab-c'); // ❌ success: false，含连字符
const result3 = alphanumeric.safeParse(''); // ❌ success: false，空字符串不通过（符合 /^[a-zA-Z0-9]+$/ 的 + 量词）</typeof></string>
⚠️ 注意事项：
- 正则 /^[a-zA-Z0-9]+$/ 要求非空且仅含 ASCII 字母与数字；若需支持 Unicode 字母（如中文、é、ñ），应改用 /^\p{L}\p{N}+$/u 并启用 Unicode 模式（注意浏览器兼容性）；
- z.custom() 第二个参数可传入 message 或完整 validation 对象，用于定制错误提示，提升用户体验与调试效率；
- 避免在 z.custom() 中执行异步或高开销操作——它应在同步校验场景下使用；
- 可进一步封装为工厂函数，支持可选参数（如最小长度、是否允许空字符串）：
const alphanumericWithOpts = (options?: { minLength?: number; allowEmpty?: boolean }) =>
z.custom<string>((val) => {
if (typeof val !== 'string') return false;
if (options?.allowEmpty && val === '') return true;
if (val === '') return false;
const baseValid = /^[a-zA-Z0-9]+$/.test(val);
return baseValid && (options?.minLength ? val.length >= options.minLength : true);
});</string>
总结：虽然 Zod 没有开箱即用的 .alphanumeric() 方法，但 z.custom() 提供了简洁、类型安全、可组合的扩展机制。合理运用它，既能满足特定校验需求，又能无缝融入 Zod 的整体生态——包括 TypeScript 类型推导、.safeParse()、.parse()、错误格式化及与其他 schema 的组合（如 z.object({ code: alphanumeric })）。
