通过 100 多个技巧学习 Nuxt!
发布·  

Nuxt 3.12

Nuxt 3.12 发布了 - 充满了改进,并为 Nuxt 4 做好准备!

我们正朝着 Nuxt 4 的发布迈进,但我们并没有在 Nuxt v3.12 中退缩。

🚀 测试 Nuxt 4 的更改

Nuxt 4 即将到来,现在可以通过在您的 nuxt.config 文件中设置一个选项来测试下一个主要版本中即将到来的行为更改 (#26925)

export default defineNuxtConfig({
  future: {
    compatibilityVersion: 4,
  },
})

当我们合并 Nuxt 4 的 PR 时,我们一直在这个标志后面启用它们。我们尽可能地追求向后兼容性 - 我们的测试矩阵在 v3 和 v4 兼容模式下运行相同的固定装置。

这里有很多要说的,有 10 多个不同的 PR 和行为更改被记录和测试,但要了解完整详细信息,包括迁移步骤,请参阅 v4 升级文档

我们非常感谢对 Nuxt 4 中即将推出的内容进行早期测试!🙏

📜 Nuxt Scripts 自动安装

我们一直在逐步发布 Nuxt Scripts。它目前处于公开预览阶段,但我们即将公开发布,因此我们添加了一些 composables 的存根,这些存根(在使用时)将提示安装 @nuxt/scripts 模块。

👉 关注发布 - 以及一篇解释更多的文章!

🌈 Layer 自动注册和错误修复

就像 ~/modules 一样,您项目中 ~/layers 目录中的任何层现在都将自动注册为项目中的层 (#27221)。

我们现在也正确加载层依赖项,这应该可以解决 monorepos 和 git 安装的一系列问题 (#27338)。

🌐 内置可访问性改进

我们现在有一个内置的 <NuxtRouteAnnouncer> 组件和相应的 useRouteAnnouncer composable,默认情况下将添加到新的 Nuxt 模板中。

有关完整详细信息,请参阅 原始 PR (#25741)文档

我们正在继续开发 nuxt/a11y - 期待在未来听到更多关于它的消息!

🔥 性能改进

我们还进行了一些性能改进,其中许多改进在 compatibilityVersion: 4 标志之后,例如从深度响应式 asyncData 有效负载中移开。

重大改进包括重复数据删除模块 (#27475) - 这将主要适用于在其层中指定模块的层用户。在一个项目中,我们看到启动 Nuxt 的速度提高了 30 秒以上。

我们还通过从预捆绑中排除常见的 ESM 依赖项来改进 Vite 开发服务器启动时间,并建议模块作者考虑这样做 (#27372)。

我们改进了 chunk 确定性,因此顺序构建不太可能具有完全不同的 chunk 哈希值 (#27258)。

我们从服务器构建中 tree shake 更多的仅客户端 composables (#27044),并减小了服务器组件有效负载的大小 (#26863)。

👨‍👩‍👧‍👦 多应用支持

我们进行了一些更改,使我们能够在 Nuxt 中本地支持多应用,包括一个 multiApp 实验性标志 (#27291) 以及在运行时并行运行多个 Nuxt 应用实例的能力 (#27068)。

虽然它尚未准备就绪,但请关注 跟踪器问题,如果这让您感兴趣,请随时参与。

⛑️ DX 胜利

我们现在在开发服务器日志中序列化更多内容,包括 VNodes (#27309) 和 URLs。我们还解决了一个可能导致开发服务器冻结的错误。

当在浏览器中访问私有运行时配置时,我们现在会用更具信息性的错误消息通知您 (#26441)。

🪨 稳定功能

我们删除了一些已稳定且我们认为不再需要配置的实验性选项

  • experimental.treeshakeClientOnly(自 v3.0.0 起默认启用)
  • experimental.configSchema(自 v3.3.0 起默认启用)
  • experimental.polyfillVueUseHead(自 v3.4.0 起禁用) - 可以使用 插件在用户端实现
  • experimental.respectNoSSRHeader(自 v3.4.0 起禁用) - 可以使用 服务器中间件在用户端实现

我们还默认启用了 scanPageMeta (#27134)。这会提取您 definePageMeta 宏中的任何页面元数据,并使其可供模块(如 @nuxtjs/i18n)使用,以便它们可以增强它。

这可以实现更好模块/类型化路由集成,但可能会产生性能成本 - 因此,如果您遇到任何问题,请提交 issue。

💪 类型改进

我们现在支持服务器组件中类型化的 #fallback 插槽 (#27097)。

我们还在您生成的 tsconfig.json 中改进了一些默认设置,包括在您安装了本地 TypeScript v5.4 版本时设置 module: 'preserve' (请参阅文档) - 请参阅 #26667#27485

📦 模块作者/高级用户改进

我们为模块作者提供了一系列类型改进,包括

  • installModule 中支持类型化的模块选项 (#26744)
  • 在模块选项中指定与特定构建器(vite/webpack)的兼容性的选项 (#27022)
  • 一个新的 onPrehydrate hook,用于挂钩到浏览器水合周期 (#27037)
  • 能够使用新的构建时 useRuntimeConfigupdateRuntimeConfig 实用程序访问和更新模块中已解析的运行时配置 (#27117)

🎨 内联 UI 模板

如果您之前使用过 @nuxt/ui-templates,那么可能值得知道我们已将它们从 单独的存储库移动到 nuxt/nuxt monorepo 中。(这纯粹是重构而不是更改,尽管您可以期待 Nuxt v4 的一些新设计。)

✅ 升级

与往常一样,我们建议的升级方式是运行

npx nuxi@latest upgrade --force

这也会刷新您的 lockfile,并确保您从 Nuxt 依赖的其他依赖项(尤其是在 unjs 生态系统中)中提取更新。

完整发行说明

阅读 Nuxt v3.12.0 的完整发行说明。

非常感谢参与此发布的 75+ 位 Nuxt 贡献者和社区成员。❤️

最后,感谢您阅读到这里!我们希望您喜欢 v3.12,如果有任何反馈或问题,请告诉我们。🙏

快乐的 Nuxting ✨