nitro

此技能基于 Nitro v3（beta，3.0.260903），生成于 2026-09-25。

Nitro 是一款与框架和部署方式无关的服务器工具包，由 H3 v2、unstorage 和 Vite/Rolldown/Rollup 提供支持。它为 Nuxt 提供支持，也可独立运行。它能从同一套代码库构建针对 Node.js、Bun、Deno、Cloudflare、Vercel、Netlify 等平台优化的输出。

主要功能：

• 文件系统路由，支持 H3 v2 事件处理器、动态参数和方法后缀。
• 路由规则，用于声明式缓存、标头、重定向、代理和 CORS。
• 基于 unstorage KV 层的缓存层（缓存处理器/函数、SWR）。
• 可通过 NITRO_* 环境变量覆盖的运行时配置。
• 任务（按需执行和定时/cron）、WebSockets/SSE、SQL 数据库层和 OpenAPI 自动文档。
• 插件和生命周期钩子、自定义渲染器/服务器入口以及可移植的部署预设。

v3 主要变更（相较于 nitropack v2）：包名从 nitropack 更名为 nitro，并采用 H3 v2（基于 Web 标准的 Request/Response）；移除了自动导入（必须显式导入所有内容）；目录扫描通过 serverDir 选择性启用；useStorage → useKV（nitro/kv），配置选项 storage → kv；缓存 swr 现在默认值为 false。如果不确定 v2 和 v3 的 API 差异，请先阅读 advanced-migration。

核心功能

主题	描述	参考
路由	基于文件的路由、defineHandler、参数、中间件、路由规则、错误	core-routing
配置	nitro.config.ts、defineConfig、关键选项、运行时配置	core-configuration
存储	unstorage KV、挂载点、驱动、动态挂载	core-storage
缓存	defineCachedHandler、defineCachedFunction、SWR、失效处理	core-cache
资源	公共资源、压缩、通过存储提供的服务器资源	core-assets
渲染	渲染器（HTML/SSR）、服务器入口、框架集成	core-rendering

功能

主题	描述	参考
插件和钩子	definePlugin、运行时生命周期钩子、错误捕获	features-plugins
任务	按需执行和定时（cron）任务、runTask	features-tasks
WebSocket 和 SSE	defineWebSocketHandler、发布/订阅、命名空间、事件流	features-websocket
数据库	通过 db0 提供的内置 SQL 层、useDatabase、连接器	features-database
OpenAPI	根据 defineRouteMeta 自动生成规范、Scalar/Swagger 界面	features-openapi

高级功能 / 部署

主题	描述	参考
部署预设	运行时和提供商、兼容性日期、平台集成	deploy-presets
v2 → v3 迁移	包名更改、nitro/* 导入、H3 v2 API、预设变更	advanced-migration