typescript 中为 defineemits 声明联合事件需用函数重载签名，因联合类型无法表达参数个数或结构差异；调用签名语法支持多组 (e: 'save', ...) 重载并兼容 jsdoc，而对象字面量语法不支持重载。
在 TypeScript 中为 defineEmits 声明支持**联合事件（即同一事件名可接受多种参数组合）**的重载类型，本质是利用 TypeScript 的**函数重载签名（Call Signatures）**机制。Vue 3 的 defineEmits 泛型接口写法完全兼容这种模式——它不接受实现体，只接收多个调用签名，由 TypeScript 在编译期匹配最合适的那一组。
为什么需要重载？不是用联合类型就够了？
联合类型（如 (data: string) => void | (data: number) => void）无法表达“参数个数或结构不同”的场景。比如：
-
save事件可能带完整表单对象：emit('save', { id: 1, name: 'A' }) - 也可能只带 ID 触发轻量保存：
emit('save', 1) - 甚至支持无参快速提交：
emit('save')
这时必须用重载，而不是 any 或宽泛联合类型，否则会丢失类型精度、IDE 无法提示、TS 不报错。
用调用签名语法声明重载 emit
这是目前最清晰、最符合 Vue 官方推荐且支持 JSDoc 文档注释的方式：
const emit = defineEmits/**
- 仅保存 ID（用于标记已读等轻量操作）
- @param id 资源唯一标识 */ (e: 'save', id: number): void;
/**
- 无参保存（例如自动同步当前草稿）
*/
(e: 'save'): void;
}>();
这样写后：
-
emit('save')✅ 合法 -
emit('save', 123)✅ 合法，id被推导为number -
emit('save', { id: 1, name: 'x' })✅ 合法 -
emit('save', 'oops')❌ 报错：没有匹配的重载 -
emit('sve')❌ 报错：事件名不存在
-
配合接口复用重载定义
当多个组件共用同一套事件契约时，把重载签名抽成接口更利于维护：
interface SaveEmits {
(e: 'save', data: FormData): void;
(e: 'save', id: number): void;
(e: 'save'): void;
(e: 'cancel'): void;
}
<p>const emit = defineEmits<saveemits>();
</saveemits></p>
接口可导出、可继承、可被测试工具消费，也方便在父组件监听时做类型对齐（例如 @save="(payload: FormData | number | undefined) => {}" 可进一步约束）。
注意：对象字面量语法不支持重载
Vue 3.3+ 推出的对象字面量写法（如 { 'save': [data: FormData] }）简洁但**只支持单一参数元组形式，无法表达多态参数结构**。一旦需要重载，必须回归调用签名语法（即花括号内写多个函数签名）。
另外，所有重载签名中的 e 参数必须严格一致（包括大小写、冒号、空格），否则会被视为不同事件而非重载。
