Nuxt3中使用建造者模式实现类时构建报错的问题咨询

问题背景 #

将Vue3项目迁移至Nuxt3时，在composables目录下实现建造者模式的类继承代码，构建时触发Identifier 'Foo' has already been declared错误。仅当类存在继承关系，且静态方法中调用自身构造函数时会出现该问题，清空composables/index.ts可解决但无法适配嵌套文件夹的类导出需求。

问题原因 #

Nuxt3的自动导入机制会自动扫描composables目录下的所有文件并注册导入，同时手动在index.ts中导出类时，会导致同一类被重复声明——尤其是类内部存在自身引用（如static build里的new Foo()）时，自动导入的识别逻辑会和手动导出产生冲突。

解决方案 #

方案1：通过Nuxt配置自动扫描所有嵌套文件，移除手动导出的index.ts #

在nuxt.config.ts中配置自动导入的扫描范围，让Nuxt自动识别composables下所有层级的文件，无需手动维护index.ts：

export default defineNuxtConfig({
  imports: {
    include: [
      '~/composables/**/*.ts'
    ]
  }
})

之后删除composables/index.ts，Nuxt会自动完成所有类的导入注册，避免重复声明问题。

方案2：改用命名导出替代默认导出 #

将类文件改为命名导出，让自动导入和手动导出的识别逻辑更清晰：

• 修改composables/Foo.ts：

import { SuperFoo } from './SuperFoo'

export class Foo extends SuperFoo {
  constructor(bar: string) {
    super(bar)
  }

  static build({ bar }: { bar: string }) {
    return new Foo(bar)
  }
}

• 修改composables/SuperFoo.ts：

export class SuperFoo {
  bar = 'baz'

  constructor(bar: string) {
    this.bar = bar
  }
}

• 修改composables/index.ts：

export * from './Foo'
export * from './SuperFoo'

这种方式下，自动导入和手动导出不会产生冲突，同时支持嵌套文件夹的类通过index.ts聚合导出。

方案3：排除index.ts的自动导入扫描 #

如果需要保留index.ts的手动导出逻辑，可在配置中让Nuxt跳过对index.ts的自动扫描：

export default defineNuxtConfig({
  imports: {
    exclude: [
      '~/composables/index.ts'
    ]
  }
})

这样index.ts的手动导出不会被自动导入机制重复处理，同时其他嵌套文件夹的文件依然能被自动识别。

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