Back to Details

nitro

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
The skill is based on Nitro v3 (beta), generated at 2026-06-22.
Nitro is a framework-agnostic, deployment-agnostic server toolkit powered by H3 v2, unstorage, and Vite/Rolldown/Rollup. It powers Nuxt and works standalone. From one codebase it builds optimized output for Node.js, Bun, Deno, Cloudflare, Vercel, Netlify, and more.
Key capabilities:
  • Filesystem routing with H3 v2 event handlers, dynamic params, and method suffixes.
  • Route rules for declarative caching, headers, redirects, proxying, and auth.
  • Caching layer (cached handlers/functions, SWR) on top of unstorage KV.
  • Runtime config overridable via 
    NITRO_*
    env vars.
  • Tasks (on-demand + scheduled/cron), WebSockets/SSE, a SQL database layer, and OpenAPI auto-docs.
  • Plugins & lifecycle hooks, custom renderer/server entry, and portable deployment presets.
Nitro v3 renamed the package 
nitropack
→ 
nitro
and adopts H3 v2 (web-standard 
Request
/
Response
). If unsure about v2-vs-v3 APIs, read advanced-migration first.
本技能基于 Nitro v3（测试版），生成于2026-06-22。
Nitro 是一款与框架、部署环境均无关的服务器工具包，由 H3 v2、unstorage 以及 Vite/Rolldown/Rollup 提供支持。它为 Nuxt 提供动力，同时也可独立使用。只需一个代码库，它就能为 Node.js、Bun、Deno、Cloudflare、Vercel、Netlify 等平台生成优化后的输出结果。
核心功能：
  • 文件系统路由：基于 H3 v2 事件处理器，支持动态参数和方法后缀。
  • 路由规则：用于声明式缓存、请求头设置、重定向、代理和认证。
  • 缓存层：构建于 unstorage KV 之上，支持缓存处理器/函数、SWR。
  • 运行时配置：可通过 
    NITRO_*
    环境变量覆盖。
  • 任务、WebSocket/SSE、数据库与OpenAPI：支持按需执行+定时（cron）任务、WebSocket/SSE、SQL数据库层，以及OpenAPI自动文档。
  • 插件与扩展：支持插件&生命周期钩子、自定义渲染器/服务器入口，以及可移植的部署预设。
Nitro v3 将包名从 
nitropack
更改为 
nitro
，并采用了 H3 v2（基于Web标准的 
Request
/
Response
）。若不确定v2与v3的API差异，请先阅读 advanced-migration。

Core

核心模块

TopicDescriptionReference
RoutingFile-based routes, 
defineHandler
, params, middleware, route rules, errors		core-routing
Configuration
nitro.config.ts
, 
defineConfig
, key options, runtime config		core-configuration
Storageunstorage KV, mount points, drivers, dynamic mountscore-storage
Cache
defineCachedHandler
, 
defineCachedFunction
, SWR, invalidation		core-cache
AssetsPublic assets, compression, server assets via storagecore-assets
RenderingRenderer (HTML/SSR), server entry, framework integrationcore-rendering
主题描述参考文档
路由基于文件的路由、
defineHandler
、参数、中间件、路由规则、错误处理		core-routing
配置
nitro.config.ts
、
defineConfig
、关键选项、运行时配置		core-configuration
存储unstorage KV、挂载点、驱动、动态挂载core-storage
缓存
defineCachedHandler
、
defineCachedFunction
、SWR、缓存失效		core-cache
资源公共资源、压缩、通过存储服务的服务器资源core-assets
渲染渲染器（HTML/SSR）、服务器入口、框架集成core-rendering

Features

功能特性

TopicDescriptionReference
Plugins & Hooks
definePlugin
, runtime lifecycle hooks, error capture		features-plugins
TasksOn-demand & scheduled (cron) tasks, 
runTask
features-tasks
WebSocket & SSE
defineWebSocketHandler
, pub/sub, namespaces, event streams		features-websocket
DatabaseBuilt-in SQL layer via db0, 
useDatabase
, connectors		features-database
OpenAPIAuto spec from 
defineRouteMeta
, Scalar/Swagger UIs		features-openapi
主题描述参考文档
插件与钩子
definePlugin
、运行时生命周期钩子、错误捕获		features-plugins
任务按需执行与定时（cron）任务、
runTask
features-tasks
WebSocket 与 SSE
defineWebSocketHandler
、发布/订阅、命名空间、事件流		features-websocket
数据库基于db0的内置SQL层、
useDatabase
、连接器		features-database
OpenAPI从
defineRouteMeta
自动生成规范、Scalar/Swagger UI		features-openapi

Advanced / Deployment

进阶 / 部署

TopicDescriptionReference
Deployment PresetsRuntimes & providers, compatibility dates, platform integrationdeploy-presets
v2 → v3 MigrationPackage rename, 
nitro/*
imports, H3 v2 API, preset changes		advanced-migration
主题描述参考文档
部署预设运行时与服务商、兼容性说明、平台集成deploy-presets
v2 → v3 迁移包名变更、
nitro/*
导入、H3 v2 API、预设变更		advanced-migration