Provide/Inject 是 Vue 中用于跨层级通信的机制，祖先组件通过 provide 提供数据（推荐 Symbol 作 key），后代组件通过 inject 获取，支持响应式数据和函数，适用于主题、权限等全局状态，但不适用于兄弟通信或细粒度状态。

Vue 中组件嵌套过深时，props 一层层往下传确实繁琐又脆弱。Provide 和 Inject 就是专为解决这种“跨层级通信”而生的机制——它不依赖父子链，允许祖先组件向任意深度的后代组件“提供”数据，后代组件按需“注入”使用。

Provide：在祖先组件中定义可被共享的数据

你只需在 setup() 中调用 provide()，传入一个 key（字符串或 Symbol）和要共享的值。这个值可以是响应式数据（ref、reactive）、函数，甚至整个 store。

• 推荐用 Symbol 作 key，避免命名冲突：const themeKey = Symbol('theme')
• provide 的值如果是 ref，后代 inject 后仍保持响应性；如果是普通对象，需用 reactive 包裹才能响应
• 常见位置：App.vue、Layout 组件、或某个业务模块的根组件

Inject：在任意后代组件中获取提供的值

在需要数据的组件 setup() 中调用 inject()，传入与 provide 一致的 key，即可拿到值。它返回的就是你提供的原始引用，修改它会影响所有注入该值的地方（注意响应性规则）。

• inject 第二个参数可设默认值（非响应式），比如 inject(themeKey, 'light')
• 如果不确定祖先是否 provide，可用 inject(themeKey, null, false) 禁用警告
• inject 返回的值不能直接解构，否则会丢失响应性——应始终通过属性访问，如 theme.value

配合响应式 + 函数，实现双向通信或状态控制

provide 不仅能传值，还能传方法。比如把修改主题的函数一起提供出去，后代组件就能触发更新，祖先组件响应式数据自动变化。

• 在 provide 里传一个包装了逻辑的函数：provide(themeKey, { theme, toggleTheme })
• inject 后直接调用 themeState.toggleTheme()，无需 emit 或事件总线
• 适合全局配置、权限状态、国际化 locale、暗色模式开关等场景

注意边界：不是万能替代，慎用于局部、临时状态

Provide/Inject 是“祖先→后代”的单向数据流设计，不适用于兄弟组件通信，也不适合传递频繁变化、粒度极细的状态（比如某个按钮的 loading）。过度使用会让数据流向变模糊，调试困难。

• 优先用 props/emits 处理明确的父子交互
• 复杂状态管理建议用 Pinia，Provide/Inject 更适合作为它的补充（如注入 store 实例）
• 服务端渲染（SSR）中需确保 provide 在 setup 阶段同步执行，避免 hydration 错误