概述

Bridge 是一个向前兼容层，让您只需安装并启用 Nuxt 模块即可体验许多新的 Nuxt 3 功能。

使用 Nuxt Bridge，您可以确保您的项目（几乎）为 Nuxt 3 做好准备，并且您可以逐步进行到 Nuxt 3 的过渡。

第一步

升级 Nuxt 2

确保您的开发服务器 (nuxt dev) 没有运行，删除任何包锁定文件 (package-lock.json 和 yarn.lock)，并安装最新的 Nuxt 2 版本

- "nuxt": "^2.16.3"
+ "nuxt": "^2.17.3"

然后，重新安装您的依赖项

npm install

安装 Nuxt Bridge

安装 @nuxt/bridge 和 nuxi 作为开发依赖项

npm install -D @nuxt/bridge nuxi

更新 nuxt.config

请确保在您的配置文件中避免任何 CommonJS 语法，例如 module.exports、require 或 require.resolve。它很快将被弃用且不受支持。

您可以使用静态 import、动态 import() 和 export default 代替。通过重命名为 nuxt.config.ts 来使用 TypeScript 也是可能的，并且是推荐的。

import { defineNuxtConfig } from '@nuxt/bridge'

export default defineNuxtConfig({
  bridge: false
})

更新命令

nuxt 命令现在应更改为 nuxt2 命令。

{
  "scripts": {
-   "dev": "nuxt",
+   "dev": "nuxt2",
-   "build": "nuxt build",
+   "build": "nuxt2 build",
-   "start": "nuxt start",
+   "start": "nuxt2 start"
  }
}

在这里尝试运行一次 nuxt2。您将看到应用程序像以前一样工作。

（如果 'bridge' 设置为 false，您的应用程序将像以前一样运行，没有任何更改。）

升级步骤

使用 Nuxt Bridge，迁移到 Nuxt 3 可以分步骤进行。以下“Upgrade Steps”不需要一次完成。

• TypeScript
• 迁移传统组合式 API
• 插件和中间件
• 迁移新组合式 API
• Meta 标签
• 运行时配置
• Nitro
• Vite

从 CommonJS 迁移到 ESM

Nuxt 3 原生支持 TypeScript 和 ECMAScript 模块。请查看 Native ES Modules 以获取更多信息和升级指南。