Agent Skills
返回列表
💻

Vue 测试最佳实践

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vuejs-ai-skills-vue-testing-best-practices。

技能介绍

你可能卡在哪些测试问题上

Vue 3 项目一上 CI,常见现象是:改了一点组件内部实现,单元测试全红;或者 flushPromises 没等够,间歇性失败;Composable 里用了 onMounted / inject,单测里直接跑不起来;Pinia 报 injection Symbol(pinia) not found;带 async setup 的组件在 mount 后一直是空树;快照全绿但线上功能坏了;Teleport 出去的弹层用 wrapper.find 永远找不到;defineAsyncComponent 包一层就测不通。这些往往不是「不会写断言」,而是测试策略和运行环境没对齐 Vue 3 的真实行为。

技能覆盖什么、怎么帮你做决策

本技能按场景索引组织,把问题映射到具体实践条目,例如:

  • 基建选型:Vue 3 单测优先走 Vitest 相关建议(参见 testing-vitest-recommended-for-vue)
  • 组件测试:倾向黑盒测对外契约,减少绑死内部结构(testing-component-blackbox-approach)
  • 异步:用 async/await 与 flushPromises 处理竞态(testing-async-await-flushpromises)
  • Composable:用 helper / wrapper 处理生命周期与 inject(testing-composables-helper-wrapper)
  • Pinia:在测试里正确挂载 store(testing-pinia-store-setup)
  • Suspense / 异步组件:让带 async setup 的组件能在测试中渲染(testing-suspense-async-components、async-component-testing)
  • 反模式:避免仅靠快照掩盖行为回归(testing-no-snapshot-only)
  • E2E:Vue 应用 E2E 框架选型(如 Playwright 相关建议,testing-e2e-playwright-recommended)
  • 运行环境:要验 computed style 或真实 DOM 事件时,区分 browser vs node runner(testing-browser-vs-node-runners)
  • Teleport:理解查询范围与挂载点(teleport-testing-complexity)

文末 Reference 指向 Vue 官方 Testing Guide、Vue Test Utils、Vitest、Playwright 文档,便于你核对 API 与配置细节。

适用边界

这是测试实践与排错索引,不是替你做项目脚手架一键生成;具体配置仍以你仓库的构建工具、测试 runner 版本为准。E2E 与单测分工、CI 并行度等团队规范需你自己落地。若问题不在上述条目(例如纯视觉回归、跨框架微前端),应结合其它专项技能或官方文档扩展。

使用场景

  • 新 Vue 3 仓库要定 Vitest 与 Vue Test Utils 的测试基建,并避免和 Vite 配置冲突
  • 组件重构后单测频繁失败,需要把断言从内部实现改为对外行为与 props/emit 契约
  • CI 里 composable 或 Pinia 相关用例报 inject/pinia 错误,需要在测试里正确挂载依赖
  • 选型 E2E 时要覆盖 Teleport 弹层、async setup 页面,并判断何时必须用 browser runner

适合人员

  • 维护 Vue 3 组件库、每次发版都要跑单测并担心重构把测试绑死在实现上的前端工程师
  • 负责前端 CI 流水线、要排查间歇性失败与 async/Pinia 环境问题的全栈或平台工程师
  • 从 Vue 2 迁移到 Vue 3、需要重写测试策略并评估 Playwright E2E 的技术负责人
  • 写大量 Composable 的业务前端,需要在不启动整页应用的情况下单测生命周期与 inject