Vue3组合式函数是实现高内聚低耦合逻辑复用的核心方式,强调单一职责、边界明确、可组合;需以use开头命名,接收ref/getter,返回解构安全的响应式对象,并在onUnmounted中清理副作用。

高内聚、低耦合的工具函数模块,本质不是“写得通用”,而是“职责清晰 + 边界明确 + 可组合”。Vue 3 的逻辑复用核心落在 组合式函数(Composable) 上,它天然支持状态与副作用的封装隔离,是实现这一目标最直接、最推荐的方式。
明确单一职责,按能力域拆分函数
一个组合式函数只解决一类问题,不混杂 UI 渲染、路由跳转、全局状态变更等跨层逻辑。例如:
-
useMousePosition:只监听并返回
x/y坐标,不触发弹窗、不修改 store - useDebounce:只提供防抖后的 ref 或执行函数,不绑定具体搜索接口
- useOperatorParams:只组装含运营商参数的对象,不发起请求、不处理响应
每个函数对外暴露的 API 都应紧扣其命名所承诺的能力,避免“顺便做点别的”。
输入可控、输出可解构,保持响应式穿透
组合式函数接收参数时,优先接受 ref、computed 或 getter 函数,并用 toValue() 统一处理;返回值始终是一个普通对象(非 reactive),内部属性为 ref 或 computed:
- 这样组件中可安全解构:
const { data, loading, refresh } = useFetch('/api/list') - 解构后仍保持响应性,模板中直接使用
{{ data }}无须额外包装 - 避免返回
reactive({ data, loading })—— 解构会丢失响应性
副作用显式声明,生命周期自动清理
所有副作用(事件监听、定时器、API 订阅、store 监听)必须在 onMounted 中注册,在 onUnmounted 中清除:
- 不要在函数顶层执行
window.addEventListener - 不要手动调用
clearTimeout后忘记赋值null,而应统一用onUnmounted - 如需监听 store 变化,用
$subscribe并在卸载时取消订阅
接口契约化:命名、类型、文档同步落地
工具函数不是写给自己看的,要让团队成员“一眼懂用途、放心敢复用”:
- 命名强制以
use开头,小驼峰,语义精准(如useFormValidation,而非useUtils) - TypeScript 接口定义完整:参数类型、返回类型、泛型约束(尤其对
useFetch这类) - 简单注释说明适用场景、注意事项(例如:“仅在浏览器环境可用”“依赖 Pinia store 初始化完成”)
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










