provide() 向后代提供依赖

最后更新:2026-10-22

provide() 向后代提供依赖

provide() 在祖先组件提供数据,任何层级后代都能用 inject 获取,避免逐层透传 props。

分组依赖注入
类型API
作用域组件内
Vue 版本3.0+
SSR 支持支持

📝 语法

provide("theme", ref("dark"))
provide("config", readonly(config))   // 建议:只读提供

⚙️ 参数

key字符串或 Symbol 作为依赖键
value任意值(ref/响应式对象可保持响应性)

返回值:无

▶ 示例

修改下面的代码,在预览区实时查看效果:

输出:

子组件显示「注入到的主题:暗色」。

💡 要点

💡 提示 提供 ref / reactive 数据可让后代保持响应性;提供普通值则是一次性快照。
⚠️ 注意 建议配合 readonly 提供:直接暴露可写状态会让任意后代都能改到祖先数据。
ℹ️ 说明 键名用 Symbol 常量可避免命名冲突(大型项目/库推荐)。
更多案例即将上线。

📚 相关教程

❓ 常见问题

Q 和 props 有什么区别?
A props 逐层显式传递;provide/inject 直接跨层级,但数据来源不如 props 直观,适合主题、配置这类全局上下文。
Q provide 的数据能修改吗?
A 能(后代拿到引用即可改),因此推荐只提供 readonly 或提供修改函数。
Q 同名键会冲突吗?
A 最近的提供者生效;用 Symbol 键可彻底避免。
Web-Tutorial.com

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核,确保内容准确可靠。如发现任何问题,欢迎向我们反馈。

100%

🙏 帮我们做得更好

我们是刚上线的编程教程站,几个人的小团队,精力有限。页面虽经检查,难免还有疏漏——链接失效、排版错乱、内容有误、语言生硬……

如果您发现了,麻烦告诉我们,我们会在收到反馈后第一时间进行修复,再次感谢您的光临 🙏