uni-app 中 provide/inject 仅在 Vue 3 + H5 平台完全可用；微信小程序、App 等平台因自定义组件系统不支持依赖注入而失效，链路会在自定义组件边界中断，推荐使用 Pinia、mitt 或 $scope 等跨平台方案。
provide 和 inject 在 uni-app 中能用，但有严重限制：它只在 Vue 3 + H5 平台下完全可用；微信小程序、App 端等基于自定义组件系统的平台中，provide 不会跨自定义组件边界传递——也就是说，祖先组件在 .vue 文件里 provide 的值，无法被 <custom-component>（哪怕是你自己写的）里的后代组件 inject 到。
这和 Vue 官方文档描述的行为不一致，是 uni-app 编译器和小程序原生组件模型共同导致的底层约束。
为什么 uni-app 里 provide/inject 经常“失效”
uni-app 把每个 `.vue` 单文件组件编译成小程序的自定义组件（如 `wx-comp`），而小程序的自定义组件系统**不支持依赖注入机制**。uni-app 的运行时无法在父子自定义组件之间建立 Vue 原生的 provide/inject 链路。
- 你在页面（Page）或根组件里
provide，只能被同层级或子层级的「普通 Vue 子组件」（非自定义组件）inject到 - 一旦中间夹了一个通过
<my-comp>引入的自定义组件（哪怕它只是个空壳），链路就断了 - 微信小程序开发者工具里不会报错，但
inject()返回undefined，且无任何 warning - H5 平台没这个问题，因为走的是纯 Vue 3 运行时
uni-app 中真正能跨层级传值的替代方案
别硬套 provide/inject，优先选这些经实测稳定的方案：
-
全局状态 +
defineStore（Pinia）：H5 / 小程序 / App 全平台兼容，响应式、类型安全、可 SSR（H5）。在main.js或app.js里初始化，任意组件直接useStore() -
页面级
$scope+getCurrentPages()：适用于页面内嵌套自定义组件场景。父页面把数据挂到this.$scope.data，子组件通过const pages = getCurrentPages(); const parent = pages[pages.length - 1];拿到并读写（注意双向绑定需手动触发this.$forceUpdate()） -
事件总线（mitt） + 页面生命周期通信：用
mitt()创建一个全局 emitter，在父组件onLoad时emit('init-context', data)，子组件onMounted订阅，解耦且跨平台 -
props 显式透传 +
v-bind="$attrs"：对“可控组件链”（比如你完全掌控的 UI 库组件）仍可用。祖先组件把需要下传的字段收集进对象，用v-bind="sharedProps"一层层往下透，比每个 props 写一遍更省事
provide 在 uni-app 里唯一安全的使用场景
仅限于「同一小程序页面内、不经过任何自定义组件封装」的纯 Vue 子组件树。例如：
<!-- page.vue -->
<template>
<view>
<child-a /> <!-- 直接 import 的 .vue 组件，非自定义组件 -->
</view>
</template>
<script setup>
import { provide, ref } from 'vue'
import ChildA from './components/ChildA.vue'
<p>const theme = ref('light')
provide('theme', theme) // ✅ 可被 ChildA 及其内部的 ChildB（也是 .vue）inject 到
</script>
- 所有组件必须是
.vue单文件，不能是<custom-comp>标签 - 不能混用
uni.createSelectorQuery或原生小程序组件（如<cover-view>）打断 Vue 组件树 - 即便满足以上，也建议加 fallback：
const theme = inject('theme', ref('default'))，避免意外 undefined
真正跨平台、跨组件边界的深层传值，靠 provide/inject 是走不通的。Pinia 或 mitt 才是 uni-app 项目里值得投入时间建模的方案。别在调试 inject 返回 undefined 时浪费两小时——先确认你当前组件是不是被编译成了小程序自定义组件。
