很多人把组合式 API 理解成「把 data 和 methods 拆开的语法糖」,但它真正改变的是逻辑的组织方式:相关代码可以放在一起,而不是被迫拆进 option 的各个抽屉里。
从 setup 开始
setup 在组件创建前执行,没有 this。响应式状态用 ref 或 reactive,派生状态用 computed,副作用用 watch / watchEffect。
最小可读示例
import { ref, computed, onMounted } from 'vue'
export function useCounter() {
const count = ref(0)
const double = computed(() => count.value * 2)
const inc = () => { count.value += 1 }
onMounted(() => console.log('mounted'))
return { count, double, inc }
}
何时抽 composable
当同一段逻辑在 2 个以上组件里出现,或单文件超过 200 行却难以定位业务时,就值得抽成 useXxx。反之,不必为了「看起来专业」而过度拆分。
和 Pinia 怎么配合
组件内的 UI 状态留在 composable;跨页面、跨模块的共享状态放进 Store。路由守卫里做登录校验,页面里只关心展示与交互——职责清晰后,bug 会少一半。