composables 比 mixins 更可靠，因其避免命名冲突、明确数据来源、支持 typescript 精准推导、简化生命周期管理，并通过参数化、可组合性与可测试性提升可控性。
Vue 3 中，Mixins 已被明确视为过时方案——它容易引发命名冲突、隐式依赖、调试困难，且 TypeScript 支持薄弱。Composition API 提供了更清晰、更可控的替代路径：通过自定义组合函数（Composables）按功能提取逻辑，实现真正可预测的复用。
为什么 Composables 比 Mixins 更可靠
Mixins 的问题不是“不能用”，而是“不可控”：
- 多个 Mixin 注入同名变量或方法时，后注册的会覆盖前一个，无提示、难追溯
- 数据来源不透明：模板中直接使用
loading，但你无法快速定位它来自哪个 Mixin - 无法类型推导：TS 很难为 Mixin 注入的属性提供精准类型，尤其在泛型场景下
- 生命周期钩子合并逻辑复杂（如多个
mounted），执行顺序易出错
用 Composable 替代 Mixin 的标准流程
以常见的“列表加载 + 分页”逻辑为例，原 Mixin 可能这样写：
export const listMixin = {
data() {
return { list: [], loading: false, page: 1 }
},
methods: {
async fetchList() {
this.loading = true
this.list = await api.getList(this.page)
this.loading = false
}
}
}
换成 Composable 后，结构清晰、职责单一、可测试、可类型化：
import { ref, onMounted } from 'vue'
<p>export function useList<t>(fetcher: (page: number) => Promise<t>) {
const list = ref<t>([])
const loading = ref(false)
const page = ref(1)</t></t></t></p><p>const fetchList = async () => {
loading.value = true
try {
list.value = await fetcher(page.value)
} finally {
loading.value = false
}
}</p><p>onMounted(fetchList)</p><p>return {
list,
loading,
page,
fetchList
}
}</p>
在组件中直接消费：
<script setup>
import { useList } from '@/composables/useList'
import { fetchUsers } from '@/api/user'
<p>const { list, loading, fetchList } = useList(fetchUsers)
</script>
进阶技巧：让 Composable 支持配置与扩展
真实业务中，逻辑往往需要定制。Composable 天然支持参数化和返回控制权：
- 接收函数参数（如
fetcher、initialPage、pageSize） - 返回可调用的方法（如
refresh()、loadMore()、reset()） - 内部可组合其他 Composable（如
useToast()或useErrorBoundary()） - 配合
provide/inject实现跨层级共享（例如全局权限上下文）
迁移旧 Mixin 的实操建议
不要逐行翻译 Mixin 到 Composable。重点做三件事：
- 识别 Mixin 中的“核心状态”（哪些 ref/reactive 是必须暴露的）
- 拆分副作用逻辑：把
mounted、watch、onUnmounted显式写进 Composable 内部 - 删除所有
this.访问，改用参数传入或从 store 获取依赖（如用户信息、API 客户端实例） - 为 Composable 编写单元测试——这是 Mixin 几乎做不到的
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
