Vue 3的emits校验机制在开发环境通过对象形式声明并配置返回布尔值的校验函数触发警告；返回false或undefined时输出warn提示，不阻断事件执行，生产环境自动静默。
Vue 3 的 emits 校验机制能在开发环境下对参数做运行时警告，前提是使用对象形式声明 emits 并为事件配置校验函数。它不会阻断事件执行，但会在控制台输出明确的 warn 提示，帮助你快速发现传参错误。
校验函数怎么写才触发警告
校验函数必须显式返回 布尔值，且只在 非生产环境（即 process.env.NODE_ENV !== 'production'）下生效：
- 返回
true：表示参数合法，无警告 - 返回
false或不返回任何值（undefined）：Vue 自动在控制台打印黄色 warning，格式类似：
[Vue warn]: Invalid event arguments: event "submit-form" expects 2 arguments but got 1. - 校验函数接收的参数，是
this.$emit()调用时除事件名外的所有后续参数
例如：this.$emit('save', user, { force: true })→ 校验函数收到(user, { force: true })
两种常用声明方式对比
数组写法（emits: ['save', 'cancel']）完全不校验，不会有任何警告。
对象写法才是启用警告的关键：
-
emits: { save: null }：声明事件但跳过校验，无警告 -
emits: { save: (user, options) => user && typeof user === 'object' }：有校验逻辑，参数不满足时触发警告
TypeScript + defineEmits 的运行时警告配合
即使用了类型定义（如 defineEmits<{ (e: 'save', u: User): void }>()），TypeScript 只做编译期检查；运行时警告仍需靠校验函数。建议两者结合：
- 用类型定义约束 IDE 补全和编译检查
- 在校验函数里补充业务逻辑判断（如
user.id > 0、options?.force === true） - 开发时看控制台 warn，上线后（production）自动静默，不影响性能
一个实用校验示例
比如封装一个上传组件，要求 upload-success 必须带 fileId 和 url：
emits: {
'upload-success': (fileId, url) => {
const valid = typeof fileId === 'string' &&
typeof url === 'string' &&
url.startsWith('https://')
if (!valid) {
console.warn('upload-success event requires valid fileId and HTTPS url')
}
return valid
}
}
当父组件误写 this.$emit('upload-success', '123') 时，控制台立刻出现 warn，但事件仍会照常抛出——这正是 Vue 设计的“提示不中断”原则。
