最简洁可靠的方式是使用 @keyup.enter 修饰符绑定输入框,语义清晰且避免重复触发;组合式 API 中可在 内定义 handleSearch 函数处理逻辑。

在 Vue 3 中监听回车键触发搜索,最简洁可靠的方式是直接用 @keyup.enter 修饰符绑定输入框,无需手动判断 key 值或加事件监听器。
基础写法:一行搞定回车搜索
模板中给 input 绑定 @keyup.enter,配合一个处理方法即可:
-
@keyup.enter表示「松开 Enter 键时触发」,语义清晰、避免重复触发(比如长按不卡顿) - 推荐用
keyup而非keydown,因为用户释放 Enter 才算一次完整操作,体验更自然 - 方法写在
methods或setup中都支持,组合式 API 下可直接定义函数
组合式 API 示例(推荐)
使用 <script setup></script> 的写法更轻量:
<template>
<input
type="text"
v-model="keyword"
placeholder="输入关键词,按回车搜索"
@keyup.enter="handleSearch"
/>
</template>
<script setup>
import { ref } from 'vue'
const keyword = ref('')
const handleSearch = () => {
if (!keyword.value.trim()) return
console.log('搜索关键词:', keyword.value)
// 这里调用 API 或路由跳转等实际逻辑
}
</script>
注意跨平台组合键兼容性
如果后续要扩展快捷键(如 Ctrl+S 保存),别硬写 .ctrl:
立即学习“前端免费学习笔记(深入)”;
- Windows 是 Ctrl 键,Mac 是 Cmd(即 Meta)键,Vue 提供
.meta修饰符自动适配 - 例如保存操作应写
@keyup.meta.s,不是@keyup.ctrl.s - 需要精确匹配(仅 Meta+S,不能带 Shift)就加
.exact:@keyup.meta.s.exact
常见误区提醒
不用再写这些冗余代码:
- 不用
event.key === 'Enter'手动判断 - 不用
addEventListener+removeEventListener管理全局监听 - 不用
@keydown.enter.prevent阻止默认行为——表单内回车默认不会提交,除非是<form></form>


















