Yup 自定义验证方法（如 compareToday）无需通过类型增强 DateLocale 来实现国际化，其默认错误消息本身即支持函数式动态返回 i18n 消息对象，可直接集成本地化系统。
yup 自定义验证方法（如 `comparetoday`）无需通过类型增强 `datelocale` 来实现国际化，其默认错误消息本身即支持函数式动态返回 i18n 消息对象，可直接集成本地化系统。
在使用 Yup 扩展自定义验证逻辑（例如日期与当前日期比较）时，开发者常误以为必须通过 TypeScript 模块声明（declare module "yup"）来增强 DateLocale 类型，才能让 setLocale 正确识别并应用自定义错误消息。但事实是：Yup 的 test() 方法原生支持函数形式的 message 参数——该函数接收 TestContext（含 path、params 等），可直接返回结构化消息对象（如 { key: 'i18n.key', values: { ... } }），从而无缝对接 i18n 框架（如 react-i18next 或 @lingui/core）。
✅ 正确做法：在 addYupMethod 中直接为 test 指定函数式 message：
import { addYupMethod, date, setLocale } from 'yup';
import { YupCompareTodayOp } from './types';
addYupMethod(date, 'compareToday', function method(
op: YupCompareTodayOp,
message?: string | ((ctx: TestContext) => Message)
) {
return this.test('compareToday', (ctx) => {
// 优先使用传入的自定义 message（支持字符串或函数）
if (typeof message === 'function') return message(ctx);
if (message) return message;
// 默认 i18n 消息对象（适配 lingui/react-i18next 等）
return {
key: 'validations.date.compareToday',
values: { path: ctx.path, op },
};
}, function validate(value) {
if (!value) return true;
const today = new Date().toDateString();
const inputDate = new Date(value).toDateString();
switch (op) {
case '=': return inputDate === today;
case '!=': return inputDate !== today;
case '': return inputDate > today;
case '>=': return inputDate >= today;
default: return true;
}
});
});
⚠️ 注意事项：
- 无需类型增强 DateLocale：setLocale({ date: { compareToday: ... } }) 并非 Yup 的标准机制；Yup 内部仅对内置规则（如 max, min, required）读取 locale.date.*，自定义规则不会被自动映射。
- message 函数优于 setLocale 配置：它更灵活、作用域明确，且避免了类型声明冲突与模块增强的维护成本。
- 保持 TestContext 类型安全：可通过 import type { TestContext } from 'yup' 显式引入上下文类型，确保 ctx.path、ctx.params 等属性正确推导。
- 避免重复 localize：若已在 message 函数中返回 i18n 对象，则 setLocale 中对应字段可完全省略，防止逻辑冗余或覆盖。
总结：Yup 的设计哲学是“验证逻辑与消息解耦”，自定义方法应将本地化逻辑内聚于 test 的 message 参数中，而非依赖全局 locale 配置。这不仅简化了类型定义，也提升了可测试性与可维护性——你只需专注验证逻辑与消息构造，无需与 Yup 内部 locale 机制博弈。
