用途：@nuxt/test-utils 是 Nuxt 官方测试工具库，当前版本 4.0.0，用于为 Nuxt 应用编写测试，覆盖组件挂载、composable 模拟、API 端点模拟与 Nuxt 运行环境搭建。
主要能力：提供 Nuxt 测试环境（vitest-environment-nuxt）、mount/render 组件辅助、mockNuxtImport 模拟 composable、registerEndpoint 模拟服务端端点、setupBun 等。v4 起 Nuxt 初始化移至 beforeAll 钩子，使 vi.mock 与 mockNuxtImport 能在 Nuxt 启动前生效；mockNuxtImport 支持 original 参数实现部分模拟；registerEndpoint 支持查询参数与 once 选项；renderSuspended 支持 rerender；mount/render 支持 CSS modules；cleanup 支持 scoped 选项；wrapper.vm 自动解包 ref。
使用方式：在测试中导入相关辅助函数；composable 调用需放在 beforeAll/beforeEach/test 内，不能放在 describe 顶层。模拟 import.meta.server/client 需先抽取到辅助模块再模拟。测试环境变量使用 .env.test。mock 工厂可用 vi.hoisted()。服务端/API 测试应放在 nuxt 环境而非 node 环境。Pinia store 可用 createTestingPinia 包装。
限制：v4 要求 vitest ^4.0.2，并收紧 happy-dom、jsdom、@jest/globals、@cucumber/cucumber、@testing-library/vue 的依赖范围；vi.mock 对未返回的导出改为抛错。具体安装命令与完整 API 细节暂未提供。