mixins选项必须是数组,如mixins: [myMixin],直接写mixins: myMixin会报错;data同名字段以组件自身为准,覆盖混入值;钩子按mixins数组顺序执行,组件自身在最后;分页混入需页面实现getList方法。

必须用数组包裹混入对象,mixins: [myMixin] 才合法,mixins: myMixin 直接报错。
mixins 选项必须是数组,不是对象
这是最常踩的坑——尤其从 Vue 2 全局 Vue.mixin() 转过来的人,容易直接写 mixins: myMixin。uni-app(无论 Vue 2 或 Vue 3 模式)严格要求 mixins 是数组类型,哪怕只引入一个混入,也得写成 mixins: [myMixin]。运行时错误提示为:invalid value for option "mixins"。
- 正确写法:
mixins: [authMixin, listMixin] - 错误写法:
mixins: authMixin或mixins: { ... } - uni-app x 的 UTS 环境下,
defineMixin定义的混入同样要进数组,不支持运行时拼接数组
data 同名字段以组件自身定义为准
混入里的 data() 和组件自身的 data() 合并时,不会浅合并或深合并,而是“覆盖优先”:组件里声明了 loading,就完全忽略混入中同名的 loading 初始值。
- 混入:
data() { return { loading: false, list: [] } } - 组件:
data() { return { loading: true } }→ 最终this.loading === true - 想让混入默认值生效?别在组件
data里重复声明该字段;或改用created()显式赋值 - 高频字段如
list、page、searchKey尤其要注意,避免无意覆盖导致分页失效或搜索清空
生命周期钩子按 mixins 数组顺序执行,组件自身在最后
多个混入共存时,created、onLoad、onReachBottom 等钩子函数不会合并,而是严格按 mixins: [a, b, c] 顺序逐个调用,组件自己的钩子永远排在末尾。
- 示例:
mixins: [authMixin, listMixin]→ 先执行authMixin.created,再listMixin.created,最后才是页面自身的created - 若
listMixin依赖权限数据(比如this.token),它就必须放在authMixin后面声明 - 混入里访问
this.$refs或this.list前,得确认这些已在前置混入或组件data中定义,否则是undefined
分页类混入必须由页面实现 getList 方法
典型分页混入会封装 onPullDownRefresh 和 onReachBottom,但内部调用的是抽象方法 this.getList()。如果页面没提供这个方法,运行时抛出:TypeError: this.getList is not a function。
- 这不是类型检查问题,是纯粹的运行时缺失
- 防御写法:在混入方法开头加判断
if (typeof this.getList !== 'function') { console.warn('getList not implemented'); return } - 文档/注释里必须明确标注:“引用该混入的页面需自行实现
async getList()” - uni-app x 的 UTS 环境不支持
throw new Error(),要用throw Erro(注意拼写)
真正难的不是写混入,而是控制好字段覆盖边界和钩子执行时序——尤其是当混入开始互相依赖、或混入与页面共享状态时,data 的“覆盖优先”和钩子的“顺序硬编码”会立刻暴露出来。别假设混入能自动等你,它永远比你快一步。


















