nuxt

Nuxt 是一个全栈 Vue 框架，提供服务端渲染、基于文件的路由、自动导入和强大的模块系统。它使用 Nitro 作为服务端引擎，可通用部署到 Node.js、无服务器和边缘平台。

此技能基于 Nuxt 5.x（5.0.0-0），生成于 2026-09-25。

**目录布局：**默认的 srcDir 是 app/——Vue 应用代码（app.vue、components/、composables/、pages/ 等）位于 app/ 下，而 server/、shared/、public/、modules/、layers/ 和 nuxt.config.ts 保留在项目根目录。~/@ 别名指向 app/；根目录请使用 ~~/@@。

Nuxt 5 注意事项：Nuxt 5 将许多之前的实验性标志设为默认值。对 Agent 影响最大的变化包括：服务端代码迁移至 Nitro v3（h3 v2，Web 标准的 Request/Response），服务端工具从 nuxt/server 导入，且默认不再自动导入，$fetch/useFetch 根据生成的路由类型提供类型，路由默认区分大小写且带类型，打包器则为 Vite 8（Rolldown）。Nuxt 5 要求 Node 22.19/24.11 及更高版本。Nitro v2 兼容层（nitroLegacy）可在迁移期间确保旧版服务端代码仍能构建。详情请参阅各个参考文档。

核心

主题	描述	参考
目录结构	Nuxt 4 app/ srcDir、shared/、别名、约定	core-directory-structure
配置	nuxt.config.ts、app.config.ts、别名、Nuxt 5 默认值、移除 jiti、实验性功能	core-config
CLI 命令	开发服务器、构建、生成、预览和实用工具命令	core-cli
路由	基于文件的路由、区分大小写且带类型的路由、命名视图、布局属性、中间件	core-routing
数据获取	useFetch、useAsyncData、$fetch、带类型的路由、createUseFetch 工厂、缓存	core-data-fetching
模块	创建和使用 Nuxt 模块、Nuxt Kit 工具	core-modules
部署	使用 Nitro、Vercel、Netlify、Cloudflare 进行平台无关的部署	core-deployment

功能

主题	描述	参考
Composables 自动导入	Vue/Nuxt composables、自定义 composables、shared/、useAnnouncer	features-composables
组件自动导入	组件命名、延迟加载、水合策略	features-components-autoimport
内置组件	NuxtLink、NuxtPage、NuxtLayout、NuxtAnnouncer、ClientOnly 等	features-components
状态管理	useState composable、适配 SSR 的状态、Pinia 集成	features-state
服务端路由	API 路由、nuxt/server 导入、Nitro v3（h3 v2）、会话、中间件	features-server

渲染

主题	描述	参考
渲染模式	Universal（SSR）、客户端（SPA）、混合渲染、路由规则	rendering-modes

最佳实践

主题	描述	参考
数据获取模式	高效获取、缓存、并行请求、错误处理	best-practices-data-fetching
SSR 与水合	避免上下文泄漏、水合不匹配、composable 模式	best-practices-ssr

高级主题

主题	描述	参考
Layers	使用可复用的层扩展应用	advanced-layers
生命周期钩子	构建时、运行时和服务端钩子	advanced-hooks
模块编写	使用 Nuxt Kit 发布模块、带键的 composables、依赖项	advanced-module-authoring