用途:Hono 是一个基于 Web 标准的超高速、轻量 Web 框架,支持从单一代码库运行于 Cloudflare Workers、Deno、Bun、AWS Lambda、Node.js 等运行时。用于构建 Web 应用与 API,也适用于查询其 API、配置与模式。
主要能力:内置丰富中间件与辅助工具,无需外部包。认证含 Basic Auth、Bearer Auth、JWT、JWK;安全含 CORS、CSRF、Secure Headers、IP Restriction;性能含 Compress、Cache、ETag、Body Limit、Timeout;工具含 Logger、Request ID、Cookie、Streaming、WebSocket;渲染含 JSX renderer、HTML helper、SSG。
必要用法:资料强调训练数据中的 Hono 知识不可靠,API 会随版本变化,写代码前必须先抓取在线文档,执行 WebFetch("https://hono.dev/llms.txt"),不得假设某 API 存在。
最佳实践:其一,校验后的请求头名称一律用小写键访问,如 value['idempotency-key'],Hono 按 Fetch API 规范将传入头键归一化为小写,大写查找会静默返回 undefined。其二,设置正确 Content-Type,否则校验会静默通过空对象:内置 json() 与 form() 校验器仅在请求 Content-Type 匹配时解析,缺失或错误会使校验器收到 {} 并通过而不抛错,测试和客户端调用需设置 Content-Type: application/json 或 application/x-www-form-urlencoded。其三,不要把处理函数抽到单独控制器文件:与 Express 不同,Hono 的路径参数类型在调用处的路由字符串上推断,移到单独文件会丢失该推断,除非编写复杂泛型;应保持处理函数与路由定义内联,确需分离时使用 hono/factory 的 factory.createHandlers()。
限制:具体版本差异、价格与完整 API 清单暂未提供。