依赖注入应作为契约式通信机制规范使用：明确提供者边界（根应用层、领域容器、功能模块）、统一Symbol/命名空间键名、传递响应式引用、注入设默认值与容错、配套工程化支持。
在复杂企业级应用中，依赖注入（provide/inject）不是“能用就行”的工具，而是需要被当作一种契约式通信机制来设计和约束。它解决的是跨层级、跨模块的业务上下文共享问题，但滥用会导致隐式依赖、调试困难、测试断裂和重构风险。规范化核心在于：明确提供者边界、统一键名管理、保障响应性、隔离作用域、可追溯可替换。
明确 provide 的责任边界与层级定位
不能在任意组件随意 provide，否则会形成“全局污染”。应严格限定为三类组件：
-
根应用层：通过
app.provide()注入真正全局、不可变或极少变更的上下文，如国际化实例i18n、主题配置theme、基础 API 工厂函数； -
领域容器组件：例如
<AppLayout>、<PageContainer>或<BusinessScope>，负责提供当前业务域内共享的状态与能力，如当前用户权限userAuth、页面级操作栏toolbarActions； -
功能模块封装组件：如
<FormBuilder>自身 provide 表单校验器、字段注册器等内部协作接口，仅对子组件生效，不向外泄漏。
禁止在普通业务子组件（如按钮、卡片）中 provide 任何业务状态——这会破坏组件的可复用性和可预测性。
使用 Symbol 键名 + 命名空间，杜绝键冲突
字符串键名在大型项目中极易重名（比如多个模块都用 'api' 或 'config'），导致注入覆盖或静默失效。必须采用唯一且可溯源的键：
立即学习“前端免费学习笔记（深入）”；
- 每个业务模块定义专属
Symbol，例如：export const USER_CONTEXT = Symbol('user-context-v2'); - 或使用命名空间字符串前缀：
provide('biz:approval:context', approvalContext);provide('ui:table:sorter', sorterInstance); - 所有 Symbol 和命名空间集中维护在
@/symbols/index.ts中，配合 TypeScript 接口声明类型，实现 IDE 自动补全与编译时校验。
始终传递响应式引用，避免解构失活
inject 接收的是响应式链接，而非快照值。常见错误是 provide 普通对象或解构后的属性：
- ❌ 错误：
provide('user', { name: 'Alice' });→ 注入后修改无效； - ❌ 错误：
const { name } = userRef.value; provide('userName', name);→ 失去响应性； - ✅ 正确：
provide(USER_CONTEXT, userRef);（直接传 ref）； - ✅ 正确：
provide(USER_CONTEXT, reactive({ name, role }));（传 reactive 对象，接收方需用toRefs解构）。
建议约定：所有 provide 的数据一律包装为 ref 或 reactive，并在文档中标明类型与响应性语义。
注入默认值 + 容错兜底，拒绝 undefined 崩溃
inject 不应裸调用，必须设置合理默认值或工厂函数：
- 基础默认值：
const api = inject(API_CLIENT, null);—— 显式允许为空，组件内做空判断； - 安全兜底：
const theme = inject(THEME_KEY, () => createDefaultTheme());—— 工厂函数确保惰性创建、避免副作用； - 开发环境强校验：
if (!api) throw new Error('[Inject] API_CLIENT is missing. Did you wrap with <apiprovider>?');</apiprovider>—— 配合 eslint 插件自动检查 provide 缺失。
对于关键上下文（如路由、权限），建议封装一个 useRequiredInject(key) 组合式函数，统一报错提示和追踪来源。
配套工程化与可观测性支持
规范化不止于代码写法，还需支撑体系：
- 在构建流程中插入 Babel / Vite 插件，扫描所有
provide调用并生成依赖关系图； - 为 inject 添加 Devtools 标签，显示来源组件路径与 provide 时间戳；
- 单元测试中用
render(..., { provide: { ... } })显式模拟上下文，避免依赖真实祖先树； - 文档化每个 Symbol 键的用途、生命周期、变更影响范围，纳入 Confluence 或 Storybook。
不复杂但容易忽略：依赖注入的价值不在“省几行 props”，而在于让跨模块协作变得可声明、可验证、可演进。
