Nuxt3组件单元测试报错：无法解析组件导入路径

报错信息 #

FAIL test/components/button.test.ts [ test/components/button.test.ts ]
Error: 无法解析从 "components\Button\Button.vue" 导入的 "@/components/Texts/Button/ButtonText.vue"。该文件是否存在？

相关代码 #

button.test.ts #

import {test, expect} from 'vitest';
import {mount} from '@vue/test-utils';
import Button from "../../components/Button/Button.vue";

test('Button Component', async () => {
    const button = mount(Button, {
        props: {
            text: 'My Test Button'
        }
    });
    expect(button.text()).toEqual('My Test Button');
});

Button.vue #

<template>
  <div class="Button">
    <slot name="left" />
    <ButtonText :text="text" />
    <slot name="right" />
  </div>
</template>

<script lang="ts">
export default {
  name: 'Button',
  components: {ButtonText},
  props: {
    // 按钮显示文本
    text: {
      type: String as () => string,
      default: 'Button',
      required: true,
    },
  }
}
</script>

解决思路 #

• 核对文件路径：确认ButtonText.vue的实际存储路径是否与@/components/Texts/Button/ButtonText.vue完全一致，注意区分大小写（类Unix系统敏感）和路径分隔符（建议统一用/）。
• 手动导入子组件：Nuxt3的自动导入在单元测试环境可能不生效，需在Button.vue的脚本中显式导入ButtonText：

  import ButtonText from '@/components/Texts/Button/ButtonText.vue'
  

  再通过components: {ButtonText}注册。
• 配置Vitest路径别名：在vitest.config.ts中添加@别名映射，确保测试环境能识别Nuxt的路径别名：

  import { defineConfig } from 'vitest/config'
  import vue from '@vitejs/plugin-vue'
  import { resolve } from 'path'
  
  export default defineConfig({
    plugins: [vue()],
    resolve: {
      alias: {
        '@': resolve(__dirname, './')
      }
    }
  })
  

• 检查Nuxt自动导入配置：若依赖组件自动导入，确认nuxt.config.ts中启用了components模块，且ButtonText所在目录在扫描范围内：

  export default defineNuxtConfig({
    components: true, // 或指定目录如 { dirs: ['~/components'] }
  })
  

  但单元测试场景下，手动导入子组件的方案更可靠。

内容的提问来源于stack exchange，提问作者npl85