通过 100 多个技巧学习 Nuxt!

特性

启用或禁用可选的 Nuxt 特性以解锁新的可能性。

Nuxt 的某些特性是可选的,或者可以根据你的需要禁用。

features

inlineStyles

在渲染 HTML 时内联样式。这目前仅在使用 Vite 时可用。

你还可以传递一个函数,该函数接收 Vue 组件的路径,并返回一个布尔值,指示是否内联该组件的样式。

nuxt.config.ts
export default defineNuxtConfig({
  features: {
    inlineStyles: false // or a function to determine inlining
  }
})

noScripts

禁用渲染 Nuxt 脚本和 JS 资源提示。也可以在 routeRules 中进行精细配置。

nuxt.config.ts
export default defineNuxtConfig({
  features: {
    noScripts: true
  }
})

future

还有一个 future 命名空间,用于提前选择加入将在框架的未来(可能是主要)版本中成为默认的新特性。

compatibilityVersion

此配置选项在 Nuxt v3.12+ 中可用。请注意,目前,你需要在你选择加入 Nuxt 4 行为的每个层中定义兼容性版本。在 Nuxt 4 发布后,这将不再需要。

这可以提前访问 Nuxt 功能或标志。

compatibilityVersion 设置为 4 会在整个 Nuxt 配置中更改默认值,以选择加入 Nuxt v4 行为,但是你可以在测试时精细地重新启用 Nuxt v3 行为(请参见示例)。如果这样做,请提交问题,以便我们可以在 Nuxt 或生态系统中解决。

export default defineNuxtConfig({
  future: {
    compatibilityVersion: 4,
  },
  // To re-enable _all_ Nuxt v3 behaviour, set the following options:
  srcDir: '.',
  dir: {
    app: 'app'
  },
  experimental: {
    scanPageMeta: 'after-resolve',
    sharedPrerenderData: false,
    compileTemplate: true,
    resetAsyncDataToUndefined: true,
    templateUtils: true,
    relativeWatchPaths: true,
    normalizeComponentNames: false
    defaults: {
      useAsyncData: {
        deep: true
      }
    }
  },
  features: {
    inlineStyles: true
  },
  unhead: {
    renderSSRHeadOptions: {
      omitLineBreaks: false
    }
  }
})

typescriptBundlerResolution

这为 TypeScript 启用了“Bundler”模块解析模式,这是像 Nuxt 和 Vite 这样的框架的推荐设置。

当使用带有 exports 的现代库时,它可以改善类型支持。

请参阅 原始 TypeScript 拉取请求

nuxt.config.ts
export default defineNuxtConfig({
  future: {
    typescriptBundlerResolution: true
  }
})