Nuxt 4.6 与 Nuxt CLI v4 同步发布：nuxt/server 迈向服务端无关，重建 typed $fetch，并强化 Agent 友好开发体验

核心背景与行业痛点

AICoder 本身跑在 Nuxt 上，框架次版本会直接影响构建、SSR 与本地 Agent 开发体验。10 月 5 日官方账号 @nuxt_js 与博客 Nuxt 4.6 同步宣布：Nuxt 4.6 与 @nuxt/cli v4 同日发布。此前服务端类型与工具链深度耦合 h3/Nitro，大路由项目上 typed $fetch 易触发 TS2589；Agent 再起一个 nuxt dev 也常抢端口。4.6 正是对着这些问题开刀，并为 Nuxt 5 铺路。

架构亮点与底层机制

• nuxt/server：与 nuxt/app 对等的服务端导入面，基于可移植 RequestEvent（req/url/res）；默认仍由 Nitro 实现，模块可只依赖 nuxt/server 而不 peer h3/nitropack。
• typed $fetch：改走 fetchdts 路由树，类型成本随调用点而非路由数增长；可携带 body/query/headers 校验信息。
• appSecret + 会话：runtimeConfig.appSecret（NUXT_APP_SECRET），useSession 用 iron 密封 cookie，无需服务端存储。
• Vue Vapor：interop 模式下单组件/页面可开 Vapor（需 Vue ^3.6.0-rc.2+）。
• CLI v4：交互式 TUI、请求级日志、.nuxt/ 锁文件、nuxt curl/nuxt task/nuxt docs；错误经 my-bad，可复制成 Agent 提示。

权威 Benchmark 与实测跑分对比

以下均为官方发布机（arm64 Linux、Node 24.15、五次中位数）自报，非第三方复现：@nuxt/cli 安装 13.1→3.5 MB、依赖 70→31、nuxt dev 首屏 330→50 ms、端口就绪 338→104 ms、闲置内存 630→440 MB；@nuxt/kit 安装 6.4→2.1 MB；starter build 4.4→3.6 s（-18%），200 页应用 11.6→10.3 s（-11%）；含 300 个 <NuxtLink> 的页 SSR 110→140 req/s（+26%）。typed $fetch：300 路由从约 577 万实例化/3.49 s（TS2589）降至约 5.2 万/0.16 s，峰值内存 946→140 MB。

开发者实战落地与开箱指南

升级：npx nuxt upgrade --dedupe。Node 要求 ^22.22.3 || ^24.15.0 || >=26.0.0。启用新 typed fetch：experimental.routeTypedFetch: true。服务端示例：import { defineEventHandler, getQuery } from 'nuxt/server'（勿与 h3 自动导入混用，否则 NUXT_E8012）。想预览 Nuxt 5 默认行为：future.compatibilityVersion: 5。完整说明见 博客、GitHub Release 与 server imports 指南。npm 上 4x 标签已为 4.6.0（latest 可能仍短暂指向 4.5.2，请按标签或精确版本安装）。