在 Vue 单元测试中为 inject() 提供默认模拟值的核心思路是让被测组件能“找到”依赖的注入项，通常通过 global.provide、mock inject 函数或 app.provide 实现，需注意响应式处理、Symbol key 一致性及避免修改注入值。
在 Vue 单元测试中为 inject() 提供默认模拟值，核心思路是：**让被测组件在运行时能“找到”它所依赖的注入项，而无需真实祖先组件提供**。这通常通过测试环境手动调用 provide() 或直接 mock inject 的行为来实现。
在测试组件中主动 provide 模拟数据
这是最自然、也最贴近真实运行逻辑的方式。你创建一个包裹被测组件的测试组件（或使用 mount 的 global.provide 选项），并在其中显式调用 provide，把模拟值提前注入下去。
- 使用
mount的global.provide（推荐，简洁）：
<!-- 测试文件 -->
import { mount } from '@vue/test-utils'
import MyComponent from '@/components/MyComponent.vue'
test('injects config with default fallback', () => {
const wrapper = mount(MyComponent, {
global: {
provide: {
'apiUrl': 'https://mock.api/',
'theme': 'light'
}
}
})
expect(wrapper.vm.$options.inject).toContain('apiUrl')
expect(wrapper.vm.apiUrl).toBe('https://mock.api/')
})
- 如果被测组件用了 Composition API +
inject，且未设默认值，global.provide同样生效；若设置了默认值（如inject('key', 'fallback')），则只有在未provide时才回退，默认值本身不参与 mock。
对 inject 函数本身做 jest mock（适用于复杂逻辑或边界覆盖）
当需要精确控制注入行为（比如模拟未提供时返回 undefined、抛错、或动态返回不同值），可直接 mock vue 中的 inject 函数。
立即学习“前端免费学习笔记（深入）”；
- 在测试前 mock：
// mock inject 行为
import { inject } from 'vue'
jest.mock('vue', () => ({
...jest.requireActual('vue'),
inject: jest.fn((key) => {
if (key === 'user') return { id: 1, name: 'test-user' };
if (key === 'config') return { timeout: 5000 };
return undefined; // 其他 key 返回 undefined
})
}))
递归分析 Vue 项目组件依赖，从入口文件生成组件层级图，支持 Vue 2/3，输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。
- 注意：这种方式会全局影响所有测试，建议用
beforeEach+jest.restoreAllMocks()隔离；更适合验证组件对缺失依赖的容错逻辑。
配合应用级 provide 做统一测试配置
若项目中大量使用 app.provide()（例如插件注册全局配置），可在测试入口统一创建 app 并提供模拟值，再挂载组件：
- 示例（使用
createApp）：
import { createApp } from 'vue'
import { mount } from '@vue/test-utils'
import MyComponent from '@/components/MyComponent.vue'
test('uses app-level injected config', () => {
const app = createApp({})
app.provide('i18n', { locale: 'zh-CN', t: (k) => k })
const wrapper = mount(MyComponent, { app })
expect(wrapper.vm.$i18n.locale).toBe('zh-CN')
})
- 此方式特别适合测试插件或跨模块共享的上下文（如权限、国际化、API client）。
关键注意事项
响应式需显式处理：若注入的是响应式对象（如 ref 或 reactive），测试中也应提供响应式版本，否则组件内无法触发更新。
Symbol key 要保持一致：若生产代码用 Symbol 作注入名（防冲突），测试中必须导入并使用同一个 Symbol 实例，不能新建。
避免修改注入值：测试中不应直接修改 inject 得到的对象（尤其响应式），这会污染其他测试；应通过重新 provide 新值来模拟变更。
