Zod 本身不提供原生的 alphanumeric 校验方法，但可通过 z.custom() 创建类型安全、可复用的自定义 schema，结合正则高效完成校验，且完全兼容 Zod 的错误处理与类型推导机制。
zod 本身不提供原生的 alphanumeric 校验方法，但可通过 `z.custom()` 创建类型安全、可复用的自定义 schema，结合正则高效完成校验，且完全兼容 zod 的错误处理与类型推导机制。
Zod 的设计理念强调“显式优于隐式”，因此并未内置 alphanumeric() 这类语义化方法——它更鼓励开发者通过组合或定制来明确表达约束意图。虽然问题中希望“不使用正则”，但需客观指出：在 JavaScript/TypeScript 环境下，严谨判断字符串是否仅含字母和数字，正则表达式（如 /^[a-z0-9]+$/i）仍是标准、高效且无歧义的方案。Zod 的 z.custom() 正为此类场景而设计，它既保持类型安全性，又允许你封装业务逻辑。
以下是一个生产就绪的实现示例：
import { z } from 'zod';
// ✅ 推荐：带清晰错误提示、支持空字符串控制的自定义 schema
const alphanumeric = z.custom<string>(
(val) => typeof val === 'string' && /^[a-z0-9]*$/i.test(val),
{
message: 'String must contain only letters and digits',
}
);
// 若需非空校验，可链式组合
const nonEmptyAlphanumeric = alphanumeric.min(1, 'String must not be empty');
// 使用示例
const result = nonEmptyAlphanumeric.safeParse('abc123');
console.log(result.success); // true
console.log(result.data); // "abc123"
const fail = nonEmptyAlphanumeric.safeParse('ab-c');
console.log(fail.success); // false
console.log(fail.error.issues[0].message); // "String must contain only letters and digits"</string>
⚠️ 注意事项：
- z.custom() 的回调函数必须返回 true 或 false；返回其他值（如 undefined）会导致校验失败。
- 正则中 ^ 和 $ 锚点至关重要，防止部分匹配（如 'abc123!'.match(/[a-z0-9]+/i) 会误判为通过）。
- 如需支持 Unicode 字母（如中文、é、ñ），应改用 \p{L} + \p{N} 并启用 u 标志：/^\p{L}\p{N}*$/iu，但需注意浏览器兼容性。
- 避免在 z.custom() 中执行异步或高开销操作——Zod 的校验设计为同步轻量。
总结：Zod 没有 alphanumeric() 内置方法，这不是缺陷，而是其可扩展哲学的体现。通过 z.custom() 封装正则校验，你获得的是零依赖、类型精确、错误可控、可复用的高质量 schema —— 这正是 Zod 在类型优先开发中的核心价值。
