层
Nuxt 提供了一个强大的系统，允许你扩展默认文件、配置等等。
Nuxt 的核心功能之一是层和扩展支持。你可以扩展默认的 Nuxt 应用程序以重用组件、实用工具和配置。层的结构几乎与标准 Nuxt 应用程序相同，这使得它们易于编写和维护。
用例
- 使用
nuxt.config和app.config在项目之间共享可重用配置预设 - 使用
app/components/目录创建组件库 - 使用
app/composables/和app/utils/目录创建实用工具和组合式函数库 - 创建 Nuxt 模块预设
- 在项目之间共享标准设置
- 创建 Nuxt 主题
- 通过在大型项目中实施模块化架构和支持领域驱动设计 (DDD) 模式来增强代码组织。
使用
默认情况下，你的项目中的 ~~/layers 目录中的任何层都将自动注册为你的项目中的层。
层自动注册在 Nuxt v3.12.0 中引入。
此外，每个层的 srcDir 的命名层别名将自动创建。例如，你将能够通过 #layers/test 访问 ~~/layers/test 层。
命名层别名在 Nuxt v3.16.0 中引入。
此外，你可以通过将 extends 属性添加到你的 nuxt.config 文件中来从一个层扩展。
nuxt.config.ts
export default defineNuxtConfig({
extends: [
// Extend from a local layer
'../base',
// Extend from an installed npm package
'@my-themes/awesome',
// Extend from a git repository
'github:my-themes/awesome#v1',
],
})
如果你正在从私有 GitHub 仓库扩展，你也可以传递一个身份验证令牌
nuxt.config.ts
export default defineNuxtConfig({
extends: [
// per layer configuration
['github:my-themes/private-awesome', { auth: process.env.GITHUB_TOKEN }],
],
})
你可以通过在层源旁边的选项中指定别名来覆盖层的别名。
nuxt.config.ts
export default defineNuxtConfig({
extends: [
[
'github:my-themes/awesome',
{
meta: {
name: 'my-awesome-theme',
},
},
],
],
})
Nuxt 使用unjs/c12等等unjs/giget用于扩展远程层。查看文档以获取更多信息和所有可用选项。
层优先级
使用多个层时，了解它们如何相互覆盖非常重要
extends中的层 - 靠前的条目具有更高的优先级（第一个覆盖第二个）- 从
~~/layers目录中自动扫描的本地层按字母顺序排列（Z 覆盖 A） - 你的项目在堆栈中具有最高优先级 - 它将始终覆盖其他层
nuxt.config.ts
export default defineNuxtConfig({
extends: [
// Highest priority (among extends)
'../base',
// Medium priority
'@my-themes/awesome',
// Lower priority
'github:my-themes/awesome#v1',
],
// Your project has the highest priority
})
这意味着如果多个层定义相同的组件、配置或文件，则将使用优先级更高的那个。