typescript 中 defineemits 应使用调用签名语法精确约束事件名、参数个数、类型及可选性，如 (e: 'submit', data: formdata, options?: submitoptions) => void，并支持 jsdoc 注释与联合类型。
在 TypeScript 中为 defineEmits 编写严谨的事件参数类型约束，核心是让每个事件名、参数个数、参数类型、可选性都在编译期被精确校验，而不是仅靠字符串数组做名义声明。
用调用签名语法明确每个事件的完整调用形式
这是最直观、最贴近实际调用方式的写法，IDE 补全和错误提示最精准：
- 每个签名形如
(e: 'submit', data: FormData, options?: SubmitOptions) => void，其中e是事件名字面量，后续参数即emit调用时除事件名外的所有实参 - 支持 JSDoc 注释，便于生成文档或悬停查看说明
- 可选参数用
?标记，联合类型（如string | number）直接写入参数位置 - 示例：
const emit = defineEmits /** 提交表单 */
(e: 'submit', data: { id: number; name: string }): void;
/** 取消操作，无参数 */
(e: 'cancel'): void;
/** 更新模型值，支持 v-model 语法糖 */
(e: 'update:modelValue', value: string): void;
();
用对象字面量语法（Vue 3.3+ 推荐）提升可读性与严格性
该语法更简洁，对参数顺序和类型校验更严格，尤其适合参数结构清晰的场景：
- 键为事件名（支持带冒号的命名，如
"update:modelValue"），值为元组类型[param1: Type1, param2?: Type2] - 元组中可添加参数名（如
value: string），增强可读性，但不参与类型检查 - 空参数事件写成
[]，单参数写成[value: string]，多参数按顺序列出 - 示例：
const emit = defineEmits 'submit': [{ id: number; name: string }];
'cancel': [];
'update:modelValue': [value: string];
();
用泛型接口复用复杂事件定义
当事件逻辑复杂、跨组件共享或需继承扩展时，把类型抽成接口更利于维护：
- 先定义接口，可导出、可被其他组件 import，也可配合
extends扩展 - 接口内仍使用调用签名或对象字面量风格，保持类型精度
- 适合中大型项目中的表单组件、弹窗组件、数据表格等高频通信场景
- 示例：
interface FormEmits {
(e: 'submit', data: FormPayload): void;
(e: 'validate-fail', errors: Record): void;
}
const emit = defineEmits();
避免弱类型陷阱：不用纯字符串数组声明
像 defineEmits(['submit', 'cancel']) 这类写法应仅用于原型验证或极简子组件：
- 完全不校验参数个数和类型，
emit('submit', 'oops')不会报错 - 父组件监听时，回调参数只能手动标注
@submit="(d: any) => {}"，失去类型推导 - 无法体现事件语义，比如某个事件是否必传、哪些字段可选、参数结构是否嵌套
- 一旦项目进入协作阶段，这类写法会显著增加调试和重构成本
