使用 defineemits 声明事件并用 emit 触发：数组声明事件名，对象声明带类型校验；emit 按序传参，事件名须短横线格式；必须大小写及连字符完全一致，且不可在异步前触发。
![emit 语法糖怎么在 `<script setup>` 中简洁地定义和触发自定义事件">` 中简洁地定义和触发自定义事件"></p>
<p>在 `<script setup>` 中用语法糖定义和触发自定义事件，核心就两步：先用 `defineEmits` 声明事件列表，再用返回的 `emit` 函数触发。写法简洁、类型友好，且 Vue 会自动做校验。</script></p>
<h3>怎么声明事件（defineEmits）</h3>
<p>直接调用 `defineEmits`，传入事件名数组或对象：</p>
<ul>
<li>数组写法（最常用）：<code>const emit = defineEmits(['submit-form', 'cancel-edit'])</code>
</li>
<li>对象写法（带类型提示）：<code>const emit = defineEmits({ 'submit-form': (data: FormData) => true })</code> —— 这样 TS 能检查传参是否合规</li>
<li>不声明就调用会报错：TypeScript 提示“Cannot find name 'emit'”，IDE 也没补全，运行时也可能静默失败</li>
</ul>
<h3>怎么触发事件（emit）</h3>
<p>声明后得到的 `emit` 是个函数，直接调用即可：</p><div class=](https://img.php.cn/upload/article/001/242/473/179004458754882.jpg?x-oss-process=image/resize,p_40)
Emit 语法糖怎么在 `` 中简洁地定义和触发自定义事件
小雪酱_4615
2026-09-22
888人浏览
原创
- 只发事件名：
emit('submit-form') - 带一个参数：
emit('submit-form', { title: 'Hello' }) - 带多个参数：
emit('item-click', id, type, meta)，父组件监听函数会按顺序接收到全部参数 - 事件名必须用短横线格式（如
user-delete），不能用驼峰（userDelete）——HTML 模板里不区分大小写，驼峰会失效
常见搭配写法（模板里更干净）
配合模板使用时，推荐把逻辑收进函数，避免内联过长：
- 子组件模板：
<button>提交</button> - 脚本中：
const handleSubmit = () => emit('submit-form', formData) - 这样比
@click="$emit('submit-form', formData)"更易读、可复用、方便加校验或异步处理
注意几个硬性细节
这些不是建议，是必须遵守的规则：
-
事件名大小写+连字符必须完全一致：子组件 emit('user-update')，父组件就得写
@user-update，写成@userUpdate或@user_update都不触发 -
别在异步操作前 emit：比如
await save(); emit('saved')是对的，emit('saved'); await save()就可能传空值 - defineEmits 不需要从 vue 导入——它是编译时宏，直接用就行
