发布·  

Nuxt 3.3

3.3.0 是一个次要(功能)版本,带来了许多性能和开发体验改进、错误修复以及新功能。
Daniel Roe

Daniel Roe

@danielroe.dev

✨ 本地模块开发体验

我们进行了一系列更改,以启用本地模块并改善开发体验。

我们现在会自动扫描您的 ~/modules 文件夹,并将其中的顶级文件注册为项目中的模块(#19394).

当这些文件发生变化时,我们会自动重启 Nuxt 服务器。

export default defineNuxtConfig({
  modules: [
    '@nuxtjs/tailwindcss',
-   '~/modules/purge-comments'
  ]
})

我们现在还暴露了 nuxt/kit,以便在您的本地项目中轻松访问 Kit 可组合项,而无需安装 @nuxt/kit (#19422).

阅读有关本地模块的文档.

♻️ 重启 Nuxt

您可以将文件添加到 watch 数组中,以自动重启服务器(#19530)。这对于模块作者来说可能特别有用。您还可以使用新的 restart 钩子触发 Nuxt 服务器的重启(#19084).

🔥 性能改进

作为最佳实践,我们将静态资源的 maxAge 增加到 1 年(#19335),并支持对更多构建内容进行 tree-shaking (#19508).

我们现在还支持通过对象语法预加载带有路由的 <NuxtLink> (#19120):

<NuxtLink :to="{ name: 'home', query: { year: '2023' } }">Home</NuxtLink>

我们还会跟踪您使用的每个模块执行设置所需的时间,如果时间过长则发出警告。您可以通过运行带有 DEBUG=1 的开发服务器来查看所有这些值 (#18648).

DEBUG=1 npx nuxt dev
 Module pages took 1.5ms to setup.
 Module meta took 3.15ms to setup
 Module components took 4.5ms to setup.
...

您还可以选择通过配置可组合项在特定环境中进行 treeshaking (#19383) 或自动注入魔术键 (#19490).

🐛 错误处理

我们现在默认处理 chunk 错误 (#19086),这意味着如果您的网站通过重新部署进行更新,我们会在导航时自动处理重新加载

要禁用此行为,请将 experimental.emitRouteChunkError 选项设置为 'manual',并使用新的reloadNuxtApp可组合项自行处理。了解我们是如何在chunk-reload.client.ts 插件中实现的.

您还可以设置 experimental.restoreState 以在重新加载时保留部分应用程序状态

nuxt.config.ts
defineNuxtConfig({
  experimental: {
    restoreState: true
  }
})

我们还有一个新的实验性错误处理组件:<NuxtClientFallback> (#8216),它可以捕获服务器端渲染错误,用 fallback 内容替换它们,并精细地在客户端触发错误部分的重新渲染。这可以通过 experimental.clientFallback 启用 - 非常欢迎反馈!

⚡️ Head 改进

我们已迁移到直接使用unhead(#19519) - 并自动从客户端构建中 tree-shake 掉仅限服务器的 head 可组合项,例如 useServerHead (#19576),这意味着您可以在不将仅与爬虫相关的元标签逻辑包含在客户端构建中的情况下获得出色的 SEO。

还有一个新的 useHeadSafe 可组合项,用于处理对不受信任的用户输入进行净化 (#19548).

🪵 浏览器 DevTools 中更好的日志记录

与 Chrome DevTools 团队合作,我们在 unjs + Nuxt 生态系统中推出了一些功能,这意味着我们现在对在(目前基于 Chromium 的)浏览器中隐藏 Nuxt 内部堆栈跟踪提供了第一类支持#19243。我们还在涉及 Nuxt 钩子的堆栈跟踪方面进行了一些改进(unjs/hookable#69等等unjs/hookable#68)实现了console.createTask.

之前之后

💪 类型改进

服务器 API 路由的类型现在更加正确 - 非可序列化类型已从返回类型中剥离 (unjs/nitro#1002).

我们现在还对 NuxtApp 进行了更多类型化,并正确类型化未知注入以提高类型安全性 (#19643).

如果您在使用 Nuxt 数据获取可组合项时,在使用 transform + default 时遇到正确的类型问题,请不用担心 - 我们现在正确推断类型 (#19487).

⚗️ Nitro 增强功能

此版本附带 Nitro v2.3,它带来了许多自身的改进。查看发布说明了解更多信息。

我们现在支持在 Nitro 服务器路由中使用 useAppConfig (#19489) - 一个期待已久的更改。现在,useAppConfig 在您的应用程序中始终可用,用于来自层、模块等的非运行时配置。

我们还添加了一个 nitro:build:public-assets 钩子,允许修改从 Nitro 预渲染/构建阶段输出的资产 (#19638).

🛠️ 构建更改

作为向对 PNP 和 pnpm 的一流支持,无需 --shamefully-hoist迈进的一部分,我们放弃了对一些使用 CJS 解析模式的内部(已弃用)实用程序的® (#19537等等#19608).

我们现在还使用 ESM 搜索路径解析诸如 nuxt@nuxt/kit 等依赖项。我们将密切关注这一点。

我们还在为支持新的 TypeScript Node16 模块解析做准备 (#19606),作为其中的一部分,我们更改了运行时输出的格式(使用 .js 而不是 .mjs 扩展名,为子路径导出提供 types 字段,等等)。

🗺️ 自定义配置架构(高级)

我们一直在测试一个实验性功能,允许模块和用户扩展 Nuxt 配置架构 (#15592),我们现在已默认启用此功能 (#19172)。我们预计这对于模块和层/主题作者特别有用,并且应该为他们的用户带来更好的开发体验。

更新日志

查看完整的更新日志,通过比较更改或查看GitHub 上的发布.

我们衷心感谢为本次发布做出贡献的 28 位贡献者 💚