用途:面向使用 Nitro v3 框架编写服务端接口的场景,适用于纯后端 Nitro 项目初始化、Vite 项目全栈化改造,以及接口的开发与维护,也可在咨询 Nitro 开发规范时使用。
主要能力:提供接口开发的基础模板与导入规范,列出常见错误写法的正确替代方案,例如必须从 nitro/h3 导入 defineHandler、HTTPError、readBody、getQuery、getRouterParam 及 H3Event 类型;使用项目工具函数 defineApiHandler、badRequest、notFound;以 defineHandler 或 defineApiHandler 替代 defineEventHandler;以 new HTTPError({ status: 400, ... }) 替代 createError({ statusCode: 400 })。
必要用法:安装核心依赖使用 pnpm add nitro。接口文件通过 defineApiHandler 包装异步处理函数并返回数据,可附带 errorMessage 选项。示例中用户列表接口为 GET /users。
限制与补充:完整目录结构、公共类型定义、工具函数、接口模板、配置与部署、函数速查表等细节需参阅 reference.md;资料未提供 Nitro 的版本兼容范围、运行时与部署平台的限制、收费或授权信息。