v3
GitHub

配置

了解如何根据自己的需求配置 Nuxt Bridge。

特性开关

你可以选择性地禁用桥接中的某些功能，或选择使用不太稳定的功能。在正常情况下，最好始终坚持使用默认设置！

你可以查看 bridge/src/module.ts 以获取最新的默认值。

nuxt.config.ts
import { defineNuxtConfig } from '@nuxt/bridge'
export default defineNuxtConfig({
  bridge: {

    // -- 选择性启用的功能 --

    // 使用 Vite 作为打包工具，替代 webpack 4
    // vite: true,

    // 启用兼容 Nuxt 3 的 useHead
    // meta: true,

    // 启用 definePageMeta 宏
    // macros: {
    //   pageMeta: true
    // },

    // 使用 esbuild 转译 TypeScript
    // typescript: {
    //   esbuild: true
    // },

    // -- 默认启用的功能 --

    // 使用传统服务器，替代 Nitro
    // nitro: false,

    // 禁用兼容 Nuxt 3 的 `nuxtApp` 接口
    // app: false,

    // 禁用 Composition API 支持
    // capi: false,

    // ... 或者仅禁用传统的 Composition API 支持
    // capi: {
    //   legacy: false
    // },

    // 不转译模块
    // transpile: false,

    // 禁用 <script setup> 支持
    // scriptSetup: false,

    // 禁用自动导入组合函数
    // imports: false,

    // 不显示模块不兼容的警告
    // constraints: false
  },

  vite: {
    // Vite 配置
  }
})

每个选项的迁移

router.base

export default defineNuxtConfig({
- router: {
-   base: '/my-app/'
- }
+ app: {
+   baseURL: '/my-app/'
+ }
})

build.publicPath

export default defineNuxtConfig({
- build: {
-   publicPath: 'https://my-cdn.net'
- }
+ app: {
+   cdnURL: 'https://my-cdn.net'
+ }
})