CLI 提升

现在正在使用新的 Nuxt CLI，它已经独立进行版本管理。

现在可以使用以下命令来安装模块：

nuxi module add 

现在与 Vite 的 WebSocket 共享同一个端口，这意味着在开发中更好地支持 Docker 容器。

内置 Nuxt DevTools

Nuxt DevTools v1.0.0 已经发布，它已准备好作为 Nuxt 的直接依赖项发布。

自动安装 Nuxt Image

和  是内置组件。现在，会在首次使用时自动安装 @nuxt/image。

如果你在网站中使用图像，建议使用@nuxt/image，它可以应用优化来提高网站的性能。

更深层次的布局扫描

现在支持扫描 ~/layouts 中子文件夹内的布局，就像扫描 ~/components 一样。

其中最显著的改进是现在通过使用原生的fetch（在Node 18+中受支持）来在生产环境中减少约 40% 的捆绑包大小。因此，如果可能的话，建议将 Node 版本至少升级到 18 以上。

应用清单

现在支持内置的应用清单，它会在 /_nuxt/builds/meta/.json 位置生成一个清单文件。

它可以仅在预渲染的路由中加载有效载荷，如果是通过nuxt generate生成站点，还可以避免控制台中出现 404 错误。

它还启用了客户端路由规则。目前仅支持重定向路由规则；在执行客户端导航时，它们将进行重定向。

// nuxt.config.ts
export default defineNuxtConfig({
  routeRules: {
    '/about': { redirect: '/about-us' }
  }
})

// pages/index.vue

应用清单还可以实现未来的增强功能，包括通过检查 /_nuxt/builds/latest.json 来检测新部署。

如果需要，可以通过在 nuxt.config 文件中将 experimental.appManifest 设置为 false 来选择启用此行为。

范围和上下文的改进

现在为在插件中执行的 Nuxt 组合式函数定义了一个“范围”，这使得在离开网站之前可以运行同步清理操作，并使用 Vue 的onScopeDispose生命周期方法。

现在还支持 Vue composition API 的原生异步上下文，支持在 Node 和 Bun 上启用实验性的asyncContext，以支持原生的异步上下文功能。

如果遇到 Nuxt instance unavailable 这个问题，启用此选项可能会解决这个问题：

// nuxt.config.ts
export default defineNuxtConfig({
  experimental: {
    asyncContext: true
  }
})

一旦 Nuxt.js 有了跨运行时支持，将默认启用这个选项。

NuxtLink 默认值

可以使用 defineNuxtLink 工具定义自己的  组件。现在可以直接在nuxt.config文件中自定义内置的选项。

这样就可以在整个站点内强制使用尾部斜杠行为，例如：

// nuxt.config.ts
export default defineNuxtConfig({
  experimental: {
    defaults: {
      nuxtLink: {
        activeClass: 'nuxt-link-active',
        trailingSlash: 'append'
      }
    }
  }
})

数据请求改进优化

useAsyncData 和 useFetch 有两个非常重要的新功能：

现在可以设置deep: false来防止在从这些组合式函数返回的数据对象上进行深度响应。如果返回大型数组或对象，则这应该是一项性能优化。当重新获取对象时，它仍将更新；如果在数据的深层属性中更改某个属性，则它只会触发对象更新而不会触发响应式效果。

现在可以使用 getCachedData 选项来处理这些可组合项的自定义缓存。

除此之外，还支持在应用范围内为这些可组合项配置一些默认值：

// nuxt.config.ts
export default defineNuxtConfig({
  experimental: {
    defaults: {
      useAsyncData: {
        deep: false
      },
      useFetch: {
        retry: false,
        retryDelay: 100,
        retryStatusCodes: [500],
        timeout: 100
      }
    }
  }
})

层级改进优化

现在更加谨慎地按照层级的顺序加载层级插件和中间件，始终将自己的插件和中间件放在最后加载。这意味着可以依赖层级可能注入的实用工具。

如果你正在使用远程层级，现在会将这些层级克隆到的node_modules/文件夹中，这样层级就可以使用项目的依赖项。

**Nightly **发布渠道

每个 Nuxt 的main分支提交都会自动部署到一个新的版本，以供在正式发布之前进行测试。此次更新将从“edge发布渠道”改名为“nightly 发布渠道”，以避免与边缘部署混淆。

• nuxt3 现在更名为 nuxt-nightly
• nuxi-edge 现在更名为 nuxi-nightly
• @nuxt/kit-edge 现在更名为 @nuxt/kit-nightly

Nitro v2.7

Nitro v2.7 已发布，包含大量改进和错误修复。

类型导入变化

注意：此更新可能需要更改项目中的代码。

Vue 要求类型导入必须是显式的（这样Vue编译器才能正确优化和解析类型导入，例如用于props等）。

因此，Nuxt.js 团队决定在 Nuxt 项目中默认启用 verbatimModuleSyntax，这将在没有显式类型导入的情况下抛出类型错误。要解决此问题，需要更新导入语句：

- import { someFunction, SomeOptions } from 'some-library'
+ import { someFunction } from 'some-library'
+ import type { SomeOptions } from 'some-library'

如果出于某种原因需要在项目中撤消此更改，可以设置以下配置：

// nuxt.config.ts
export default defineNuxtConfig({
  typescript: {
    tsConfig: {
      compilerOptions: {
        verbatimModuleSyntax: false
      }
    }
  }
})

更新

可以通过以下命令来更新最新版本：

nuxi upgrade