迁移指南 Upgrade Guide

有要迁移的 Nuxt 2 项目吗？使用这些指南将您的应用程序升级到 Nuxt 3。

如果您已经在使用 Nuxt 3 并想升级到最新版本或在发布前测试新功能，请转到升级 Nuxt 3 部分。

功能比较

在下表中，有 3 个版本的 Nuxt 之间的快速比较：

Feature / Version	Nuxt 2	Nuxt Bridge	Nuxt 3
Vue	2	2	3
Stability	😊 Stable	😌 Semi-stable	😊 Stable
Performance	🏎 Fast	✈️ Faster	🚀 Fastest
Nitro Engine	❌	✅	✅
ESM support	🌙 Partial	👍 Better	✅
TypeScript	☑️ Opt-in	🚧 Partial	✅
Composition API	❌	🚧 Partial	✅
Options API	✅	✅	✅
Components Auto Import	✅	✅	✅
`<script setup>` syntax	❌	🚧 Partial	✅
Auto Imports	❌	✅	✅
webpack	4	4	5
Vite	⚠️ Partial	🚧 Partial	✅
Nuxi CLI	❌ Old	✅ nuxi	✅ nuxi
Static sites	✅	✅	✅

迁移指南提供了 Nuxt 2 功能与 Nuxt 3 功能的分步比较和指导，以适应您当前的应用程序。

如果您希望逐步将 Nuxt 2 应用程序迁移到 Nuxt 3，则可以使用 Nuxt Bridge。 Nuxt Bridge 是一个兼容层，允许您通过选择加入机制在 Nuxt 2 中使用 Nuxt 3 功能。

要将 Nuxt 3 升级到最新版本，请使用 nuxi upgrade 命令。

bash

npx nuxi upgrade

要在发布前使用最新的 Nuxt 3 构建和测试功能，请阅读 edge release channel 指南。