Provide 和 Inject 命名冲突的根本原因是字符串 key 易重复，最稳妥解法是用 Symbol 作唯一标识符；通过单点定义、显式导入、类型约束（如 InjectionKey）实现不可重复、不可枚举、类型安全的依赖注入。
Provide 和 Inject 命名冲突的根本原因，是用字符串作为 key 时容易重复——尤其在多人协作或引入第三方组件库时。最稳妥的解法不是靠命名规范，而是用 Symbol 作唯一标识符，让 key 天然不可重复、不可枚举、不被意外覆盖。
用 Symbol 定义稳定的 inject key
每个 Symbol 都是唯一值，即使描述相同也互不相等。把 key 提前定义为常量，供 provide 和 inject 两端一致引用：
// keys.ts
export const ThemeKey = Symbol('theme')
export const UserKey = Symbol('user')
export const ApiClientKey = Symbol('api-client')
组件中使用时直接导入，不再拼写字符串：
// 父组件
import { ThemeKey } from './keys.ts'
provide(ThemeKey, reactive({ mode: 'dark' }))
// 子组件
import { ThemeKey } from './keys.ts'
const theme = inject(ThemeKey)
避免 Symbol 泄露：封装成可复用的组合式函数
直接暴露 Symbol 常量虽安全，但耦合度高。更进一步，把 provide/inject 逻辑封装成 hook，隐藏 Symbol 细节：
- 使用者只关心“我要提供/消费主题”，不感知底层 key 是什么
- Symbol 被限制在模块内部，无法被外部误用或覆盖
- 便于统一处理默认值、类型断言、dev-only 校验等增强逻辑
// useTheme.ts
const ThemeKey = Symbol('theme')
export function provideTheme(theme: Ref<Theme>) {
provide(ThemeKey, theme)
}
export function useTheme() {
const theme = inject(ThemeKey)
if (!theme) throw new Error('useTheme must be used within a component that provides theme')
return theme
}
配合 TypeScript 实现类型安全与自动推导
Symbol 本身支持泛型标注，配合 defineInject 的类型工具（如 VueUse 的 defineInject 或自定义类型），能实现 key 与 value 类型强绑定：
- inject 时自动获得正确类型，无需手动断言
- IDE 能识别 key 对应的 value 结构，支持跳转和补全
- 如果 provide 端类型变更，inject 端会立即报错，而非运行时崩溃
const CountKey = Symbol('count') as InjectionKey<Ref<number>>
// provide 端
provide(CountKey, countRef)
// inject 端 —— 类型自动为 Ref<number>
const count = inject(CountKey)
不推荐的替代方案及风险
有人用命名空间字符串（如 'my-lib/theme'）或 WeakMap 存储 Symbol，这些方式都有隐患：
- 字符串前缀仍可能重复，且无法阻止他人用相同字符串注入假数据
- WeakMap 方案增加了间接层，调试困难，且不能跨模块共享 key
- 动态生成 Symbol（如
Symbol(Math.random())）会导致两端 key 不一致，注入失败
真正可靠的方案，始终是 单点定义 + 显式导入 + 类型约束。
