概览
减少与 Nuxt 3 的差异,降低迁移到 Nuxt 3 的负担。
如果您正在启动一个全新的 Nuxt 3 项目,请跳过此部分,直接访问 Nuxt 3 安装。
Bridge 是一个向前兼容层,您只需安装并启用 Nuxt 模块,即可体验许多新的 Nuxt 3 功能。
使用 Nuxt Bridge,您可以确保您的项目(几乎)已为 Nuxt 3 做好准备,并可以逐步进行向 Nuxt 3 的过渡。
第一步
升级 Nuxt 2
确保您的开发服务器 (nuxt dev
) 未运行,删除任何包锁文件 (package-lock.json
和 yarn.lock
),然后安装最新的 Nuxt 2 版本
package.json
- "nuxt": "^2.16.3"
+ "nuxt": "^2.17.3"
然后,重新安装您的依赖项
npm install
yarn install
pnpm install
bun install
安装完成后,请确保开发和生产构建都按预期工作,然后再继续。
安装 Nuxt Bridge
安装 @nuxt/bridge
和 nuxi
作为开发依赖项
npm install -D @nuxt/bridge nuxi
yarn add --dev @nuxt/bridge nuxi
pnpm add -D @nuxt/bridge nuxi
bun add -D @nuxt/bridge nuxi
nuxt.config
更新
请务必避免在您的配置文件中使用任何 CommonJS 语法,例如 module.exports
、require
或 require.resolve
。它将很快被弃用且不受支持。
您可以使用静态 import
、动态 import()
和 export default
代替。通过重命名为 nuxt.config.ts
来使用 TypeScript 也是可能且推荐的。
nuxt.config.ts
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 可以分步进行。下面的 升级步骤
不需要一次性完成。
从 CommonJS 迁移到 ESM
Nuxt 3 原生支持 TypeScript 和 ECMAScript Modules。有关更多信息和升级,请查看 原生 ES 模块。