极速轻量的 Web 框架，比 Express 小 40 倍！

Hono^[1] 是一个极速、轻量且简单的 Web 框架。它支持大量的 JavaScript 运行时：Cloudflare Workers、Fastly Compute、Deno、Bun、Vercel、Netlify、AWS Lambda、Lambda@Edge 和 Node.js。

Hono 的应用场景

Hono 是一个简单的 Web 应用程序框架，类似于 Express，没有前端。但它可以在 CDN 边缘网络上运行，与中间件结合后可以构建更大的应用程序。下面是一些应用场景。

• 构建 Web APIs
• 后端服务器代理
• CDN 前端
• 边缘应用程序
• 基础服务器
• 全栈应用程序

基于 Hono 开发的应用程序，已经被成功运行在 Cloudflare Workers、Bun 和 Deno 等多种 JavaScript 运行时上。下图展示了一些比较知名的应用程序：

Hono 的特性

• 超快🚀：路由器 RegExpRouter 非常快，不使用线性循环。
• 轻量级🪶：hono/tiny 小于 14kB。Hono 零依赖，并且仅使用 Web 标准 API。
• 多运行时🌍：支持 Cloudflare Workers、Fastly Compute、Deno、Bun、AWS Lambda 或 Node.js。相同的代码在所有平台上运行。
• 功能齐全🔋：内置开箱即用的中间件、支持自定义中间件、第三方中间件和多种工具类。
• 友好的开发体验😃：超简洁的 API，支持 TypeScript。

速度超快

相比 Cloudflare Workers 上 itty-router、sunder 等其他路由组件，Hono 是最快的👍：

Hono x 402,820 ops/sec ±4.78% (80 runs sampled)
itty-router x 212,598 ops/sec ±3.11% (87 runs sampled)
sunder x 297,036 ops/sec ±4.76% (77 runs sampled)
worktop x 197,345 ops/sec ±2.40% (88 runs sampled)
Fastest is Hono
✨  Done in 28.06s.

轻量

Hono 非常小。在压缩后，hono/tiny 的大小小于 14kB。提供了非常多常用的中间件和适配器，仅在使用时才进行打包。相比 Express 来说，它的尺寸是 572 kB。

$ npx wrangler dev --minify ./src/index.ts
 ⛅️ wrangler 2.20.0
--------------------
⬣ Listening at http://0.0.0.0:8787
- http://127.0.0.1:8787
- http://192.168.128.165:8787
Total Upload: 11.47 KiB / gzip: 4.34 KiB

支持多种路由

为了满足不同的使用情形，Hono 提供了多种路由组件：

• RegExpRouter 是 JavaScript 世界中最快的路由器。它使用在调度之前创建的单个大型正则表达式来匹配路径。借助 SmartRouter，它支持所有路由模式。
• LinearRouter 注册路由的速度非常快，因此适用于每次都要初始化应用程序的环境。PatternRouter 只需添加和匹配模式，因此它的体积很小。

内置丰富的中间件和工具类

Hono 提供了丰富的中间件和工具类，让 “Write Less, do more” 成为现实。

使用 Hono 添加 ETag 和请求日志只需几行代码：

import { Hono } from 'hono'
import { etag } from 'hono/etag'
import { logger } from 'hono/logger'

const app = new Hono()
app.use(etag(), logger())

友好的开发体验

Hono 提供了友好的开发体验。通过 Context 对象，可以轻松访问请求/响应。此外，Hono 是用 TypeScript 编写的，所以 Hono 拥有 “类型”。

有 TypeScript 类型系统的支持，路径参数将被推断为字面量类型。

此外，Validator 和 Hono Client 支持 RPC 模式。在 RPC 模式下，你可以使用自己喜欢的 Validator（如 Zod），轻松地与客户端共享服务器端 API 规范，并构建类型安全的应用程序。

快速开始

首先，使用 npm、yarn、pnpm、bun 或 deno 安装 hono：

npm create hono@latest
yarn create hono
pnpm create hono
bunx create-hono
deno run -A npm:create-hono

然后，从 hono 包导入 Hono 类并创建 Hono 实例：

import { Hono } from 'hono'
const app = new Hono()

app.get('/', (c) => c.text('Hono!'))

export default app

Cloudflare 提供的 CLI 工具，也提供了最精简的 honojs/hono-minimal 模板，让开发者能够基于 Hono 快速开发 Cloudflare Workers 应用程序：

npx wrangler generate my-app honojs/hono-minimal

Cloudflare Workers 的功能还是很强大的，基于它可以开发很多有用的小工具。感兴趣的话，可以浏览 Github 上 awesome-cloudflare^[2] 项目的内容。后续如果你也想开发 Cloudflare Workers、Fastly Compute 或 AWS Lambda 等 FaaS 应用，可以试试 Hono 这个轻量的开发框架。