name: nuxt description: 使用Nuxt 4+项目时使用 - 提供服务器路由、基于文件的路由、中间件模式、Nuxt特定组合式API和配置，附带最新文档。涵盖h3 v1助手（验证、WebSocket、SSE）和nitropack v2模式。更新至Nuxt 4.3+。 license: MIT
Nuxt 4+ 开发
为Nuxt 4+项目（v4.3+）提供渐进式指导，包含最新模式和约定。
何时使用
适用于：
- 服务器路由（API端点、服务器中间件、服务器工具）
- 基于文件的路由（页面、布局、路由组）
- Nuxt中间件（路由守卫、导航）
- Nuxt插件（应用扩展）
- Nuxt特定功能（自动导入、层、模块）
可用指导
根据当前工作读取特定文件：
- references/server.md - API路由、服务器中间件、验证（Zod）、WebSocket、SSE
- references/routing.md - 基于文件的路由、路由组、类型化路由器、definePage
- references/middleware-plugins.md - 路由中间件、插件、应用生命周期
- references/nuxt-composables.md - Nuxt组合式API（useRequestURL、useFetch、导航）
- references/nuxt-components.md - NuxtLink、NuxtImg、NuxtTime（优于HTML元素）
- references/nuxt-config.md - 配置、模块、自动导入、层
对于Vue组合式API： 参见 vue 技能 composables.md（VueUse、组合式API模式）
对于UI组件： 使用 nuxt-ui 技能
对于数据库/存储： 使用 nuxthub 技能
对于内容驱动站点： 使用 nuxt-content 技能
对于创建模块： 使用 nuxt-modules 技能
对于项目脚手架/CI： 使用 ts-library 技能
加载文件
根据任务考虑加载这些参考文件：
- [ ] references/server.md - 如果创建API端点或服务器中间件
- [ ] references/routing.md - 如果设置页面、布局或路由组
- [ ] references/nuxt-composables.md - 如果使用Nuxt组合式API（useFetch、useRequestURL等）
- [ ] references/middleware-plugins.md - 如果处理中间件或插件
- [ ] references/nuxt-components.md - 如果使用Nuxt组件（NuxtLink、NuxtImg等）
- [ ] references/nuxt-config.md - 如果编辑 nuxt.config.ts
- [ ] references/project-setup.md - 如果设置CI/ESLint/构建工具
不要一次性加载所有文件。 仅加载与当前任务相关的文件。
Nuxt 4 vs 旧版本
您正在使用Nuxt 4+。 关键区别：
| 旧（Nuxt 2/3） | 新（Nuxt 4） |
|---|---|
<Nuxt /> |
<NuxtPage /> |
context.params |
getRouterParam(event, 'name') |
window.origin |
useRequestURL().origin |
| 字符串路由 | 带有路由名称的类型化路由器 |
| 分离布局/ | 使用 <slot> 的父路由 |
如果不确定Nuxt 4模式，请先阅读相关指导文件。
最新文档
何时获取最新文档：
- 此处未涵盖的新Nuxt 4功能
- 模块特定配置
- 破坏性更改或弃用
- 高级使用案例
官方来源：
- Nuxt: https://nuxt.com/docs
- h3（服务器引擎）: https://v1.h3.dev/
- Nitro: https://nitro.build/
令牌效率
主技能：约300令牌。每个子文件：约800-1500令牌。仅加载与当前任务相关的文件。