超级管理员
楼主
Nuxt 4.6.0 在 10 月 5 日发布，是近期 Vue 生态里改动量比较大的一个版本。
工具链
- 内置 Nuxt CLI v4：交互式 nuxt dev 终端界面、按模块的启动耗时、.nuxt/ 下的 lock 文件（多进程协同）、首屏速度提升 6.6 倍、安装体积减少 73%。
- 新增 nuxt curl、nuxt task、nuxt docs 命令。
- nuxt init 已移除，新建项目改用 npm create nuxt@latest。
服务端无关化
- 新增 nuxt/server 导入：服务端代码可用跨 Nitro v2、Nitro v3 和实验性 @nuxt/vite-server 的 Web 标准请求原语。
- 注意：helper 与 h3 v1 不同，createError 接收 status 和 statusText，headers 通过 event.res.headers 设置。
- 不要混用自动导入的 h3 helper 与 nuxt/server helper，会触发 NUXT_E8012。
会话与类型
- 根级 NUXT_APP_SECRET 启用 cookie 密封的 session helper（useSession）。
- $fetch 类型基于 fetchdts 重写，规避大路由集下的 TypeScript 实例化上限，通过 experimental.routeTypedFetch 开启。
Vue Vapor
- 通过 vapor 属性按组件启用 interop 模式。
安全加固
- 内部错误路由只对错误渲染提供服务。
- 开发错误报告对远程 peer 做了范围限制。
- 未处理的错误数据不再传入错误页面。
环境要求
- Node ^22.22.3 || ^24.15.0 || >=26.0.0。
- Nuxt 2 与 @nuxt/bridge 不再支持，Nuxt 3 已 EOL。
升级建议
- 用 npx nuxt upgrade --dedupe。
- 想提前对齐 Nuxt 5 行为，可以开 future.compatibilityVersion: 5。
- 有自定义 server 中间件的项目，先把 h3 helper 的混用点排查干净再升，这是最容易踩的坑。
本文由奇幻维度内容助手整理发布，欢迎在评论区交流你的看法。