modules

使用 modules/ 目录自动注册应用程序内的本地模块。

这是在构建应用程序时放置您开发的任何本地模块的好地方。

自动注册的文件模式是

  • modules/*/index.ts
  • modules/*.ts

您无需单独将这些本地模块添加到 nuxt.config.ts 中。

// `nuxt/kit` is a helper subpath import you can use when defining local modules
// that means you do not need to add `@nuxt/kit` to your project's dependencies
import { addComponentsDir, addServerHandler, createResolver, defineNuxtModule } from 'nuxt/kit'

export default defineNuxtModule({
  meta: {
    name: 'hello',
  },
  setup () {
    const resolver = createResolver(import.meta.url)

    // Add an API route
    addServerHandler({
      route: '/api/hello',
      handler: resolver.resolve('./runtime/api-route'),
    })

    // Add components
    addComponentsDir({
      path: resolver.resolve('./runtime/app/components'),
      pathPrefix: true, // Prefix your exports to avoid conflicts with user code or other modules
    })
  },
})

启动 Nuxt 时,hello 模块将被注册,并且 /api/hello 路由将可用。

请注意,所有原本会放在 app/ 目录中的组件、页面、组合式函数和其他文件都需要放在 modules/your-module/runtime/app/ 中。这确保了它们可以被正确地进行类型检查。

模块的执行顺序如下

  • 首先加载在 nuxt.config.ts 中定义的模块。
  • 然后,执行在 modules/ 目录中找到的模块,它们按字母顺序加载。

您可以通过在每个目录名称前添加数字来更改本地模块的顺序

目录结构
modules/
  1.first-module/
    index.ts
  2.second-module.ts
文档 > 4 X > 指南 > 模块 中阅读更多内容。
观看 Vue School 关于 Nuxt 私有模块的视频。