Nuxt 3 已于 31 July 2026 结束生命周期
此版本将不再接收错误修复或安全补丁。 升级到 Nuxt 4 或获取 HeroDevs 提供的延长支持

Nuxt 目录结构

了解 Nuxt 应用程序的目录结构及其使用方法。

Geprüfte Übersetzung ·0 % geprüft

Nuxt 应用程序有一个特定的目录结构,用于组织代码。该结构设计得易于理解且保持一致的使用方式。

根目录

Nuxt 应用程序的根目录是包含 nuxt.config.ts 文件的目录。该文件用于配置 Nuxt 应用程序。

应用目录及文件

以下目录与通用 Nuxt 应用程序相关:

  • assets/:网站的资源文件,由构建工具(Vite 或 webpack)处理
  • components/:应用程序的 Vue 组件
  • composables/:添加 Vue 组合式函数
  • layouts/:包裹页面并避免页面切换时重新渲染的 Vue 组件
  • middleware/:在导航到特定路由之前运行代码
  • pages/:通过基于文件的路由在 Web 应用程序中创建路由
  • plugins/:在创建 Nuxt 应用程序时使用 Vue 插件等
  • utils/:添加可在组件、组合式函数和页面中使用的应用程序通用函数

此目录还包含特定文件:

服务器目录

public/ 目录包含 Nuxt 应用程序的公共文件。此目录中的文件在根路径下提供服务,且不会被构建过程修改。

公共目录

public/ 目录包含 Nuxt 应用的公共文件。此目录内的文件在根路径下提供服务,并且不会被构建过程修改。

server/ 目录包含 Nuxt 应用程序的服务器端代码。它包含以下子目录:

  • api/:包含应用程序的 API 路由
  • routes/:包含应用程序的服务器路由(例如,动态 /sitemap.xml)
  • middleware/:在处理服务器路由之前运行代码
  • plugins/:在创建 Nuxt 服务器时使用插件等
  • utils/:添加可在服务器代码中使用的应用程序通用函数

共享目录

shared/ 目录包含 Nuxt 应用程序和 Nuxt 服务器的共享代码。这些代码既可用于 Vue 应用,也可用于 Nitro 服务器。

内容目录

content/ 目录由 Nuxt Content 模块启用。它用于使用 Markdown 文件为应用程序创建基于文件的 CMS。

模块目录

modules/ 目录包含 Nuxt 应用程序的本地模块。模块用于扩展 Nuxt 应用程序的功能。

Layers 目录

layers/ 目录可用于组织和共享可复用的代码、组件、组合式函数和配置。此目录中的 Layers 会在项目中自动注册。

Nuxt 文件

  • nuxt.config.ts 文件是 Nuxt 应用程序的主要配置文件。
  • .nuxtrc 文件是配置 Nuxt 应用程序的另一种语法(适用于全局配置)。
  • .nuxtignore 文件用于在构建阶段忽略根目录中的文件。

Was this helpful?