Hono 框架简介

typescript deepseek hono

字数统计: 1.7k阅读时长: 8 min

 2025/12/01 

Hono 是一个超快速、轻量级的 Web 框架，专门为 边缘计算 和现代 JavaScript/TypeScript 运行时而设计。它的名字在日语中意为”火焰”，象征着它的速度和轻量。

核心理念

1. 极致的性能

专为边缘环境（Cloudflare Workers、Deno、Bun 等）优化
极小的包体积（~14KB）
在边缘环境中比 Express、Fastify 等传统框架快很多

2. 跨平台兼容

// 同一份代码运行在多个平台
import { Hono } from 'hono'

const app = new Hono()

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

// 支持以下所有平台：
export default app // Cloudflare Workers
Deno.serve(app.fetch) // Deno
Bun.serve({ fetch: app.fetch }) // Bun
export default app // Vercel/Netlify Edge Functions
// 甚至 Node.js!

3. 简洁的 API 设计

const app = new Hono()

// 路由定义简洁直观
app.get('/users/:id', async (c) => {
  const id = c.req.param('id')
  const user = await db.users.find(id)
  return c.json(user)
})

// 支持 RESTful 所有方法
app.post('/users', createUser)
app.put('/users/:id', updateUser)
app.delete('/users/:id', deleteUser)

核心特性

Context 对象

所有操作围绕 Context 对象展开：

app.get('/hello', (c) => {
  // c 是 Context 对象，包含：
  c.req // 请求对象
  c.res // 响应对象
  c.env // 环境变量
  c.executionCtx // 执行上下文
  c.json({ message: 'Hello' }) // 响应辅助方法
  c.text('Hello')
  c.html('<h1>Hello</h1>')
  c.redirect('/new-url')
})

中间件系统

// 内置中间件
import { logger, cors, secureHeaders } from 'hono/middleware'

app.use('*', logger())
app.use('/api/*', cors())
app.use('*', secureHeaders())

// 自定义中间件
const authMiddleware = async (c, next) => {
  const token = c.req.header('Authorization')
  if (!token) return c.text('Unauthorized', 401)
  await next()
}

app.use('/admin/*', authMiddleware)

验证和类型安全

import { z } from 'zod'
import { zValidator } from '@hono/zod-validator'

const schema = z.object({
  name: z.string().min(1),
  email: z.string().email(),
  age: z.number().min(0)
})

app.post('/users', zValidator('json', schema), (c) => {
  const data = c.req.valid('json') // 类型安全的验证数据
  return c.json({ success: true })
})

模板渲染

// JSX/TSX 支持（边缘友好）
app.get('/page', (c) => {
  return c.html(
    <html>
      <body>
        <h1>Hello Hono</h1>
        <p>Current time: {new Date().toLocaleTimeString()}</p>
      </body>
    </html>
  )
})

// Mustache 模板
import { mustache } from 'hono/mustache'
app.get('/template', (c) => {
  return c.render(
    mustache('<h1>Hello {{name}}</h1>', { name: 'World' })
  )
})

平台适配器

Cloudflare Workers

// wrangler.toml
// [env.production]
// name = "my-hono-app"

import { Hono } from 'hono'
import { handle } from 'hono/cloudflare-pages'

const app = new Hono()
app.get('/', (c) => c.text('Hello Cloudflare!'))

// Pages Functions
export const onRequest = handle(app)

// Service Worker 模式
export default app

Deno

import { Hono } from 'https://deno.land/x/hono/mod.ts'

const app = new Hono()
app.get('/', (c) => c.text('Hello Deno!'))

Deno.serve(app.fetch)

Bun

import { Hono } from 'hono'

const app = new Hono()
app.get('/', (c) => c.text('Hello Bun!'))

Bun.serve({
  port: 3000,
  fetch: app.fetch
})

Node.js

import { Hono } from 'hono'
import { serve } from '@hono/node-server'

const app = new Hono()
app.get('/', (c) => c.text('Hello Node.js!'))

serve(app, (info) => {
  console.log(`Server is running on http://localhost:${info.port}`)
})

Vercel/Netlify Edge

import { Hono } from 'hono'

const app = new Hono()
app.get('/', (c) => c.text('Hello Edge!'))

export default app
// 配置 vercel.json 或 netlify.toml 即可

高级特性

路由分组和组合

// 路由分组
const bookRoutes = new Hono()
bookRoutes.get('/', (c) => c.text('List books'))
bookRoutes.get('/:id', (c) => c.text(`Book ${c.req.param('id')}`))

// 组合路由
const apiRoutes = new Hono()
  .route('/books', bookRoutes)
  .route('/authors', authorRoutes)

app.route('/api', apiRoutes)

WebSocket 支持

import { Hono } from 'hono'
import { upgradeWebSocket } from 'hono/ws'

const app = new Hono()

app.get('/ws', upgradeWebSocket((c) => ({
  onMessage(event, ws) {
    console.log('Message:', event.data)
    ws.send('Hello Client!')
  },
  onClose() {
    console.log('Connection closed')
  }
})))

OpenAPI 集成

import { OpenAPIHono } from '@hono/zod-openapi'

const app = new OpenAPIHono()

app.openapi(
  {
    method: 'get',
    path: '/users/{id}',
    responses: {
      200: {
        description: 'Get user by ID',
        content: { 'application/json': { /* schema */ } }
      }
    }
  },
  (c) => {
    const id = c.req.param('id')
    return c.json({ id, name: 'John' })
  }
)

// 自动生成 OpenAPI 文档
app.doc('/doc', {
  openapi: '3.0.0',
  info: { title: 'My API', version: '1.0.0' }
})

性能对比

框架	冷启动时间	内存占用	包大小	适合场景
Hono	~5ms	~5MB	~14KB	边缘计算
Express	~100ms	~30MB	~200KB	传统服务器
Fastify	~50ms	~20MB	~150KB	高性能 API
tRPC	~20ms	~15MB	~100KB	全栈类型安全

使用场景

非常适合

✅ 边缘函数 - Cloudflare Workers、Vercel Edge
✅ API 网关 - 轻量级代理和路由
✅ 微服务 - 快速构建小型服务
✅ Jamstack 后端 - 配合静态站点
✅ 实时应用 - WebSocket + 边缘计算
✅ Serverless 函数 - 冷启动快

不太适合

❌ 传统 MVC 应用 - 需要完整框架特性
❌ 企业级复杂应用 - 可能需要更多内置功能
❌ 需要大量第三方中间件

生态系统

官方包

hono/middleware - 常用中间件
hono/validator - 验证工具
@hono/zod-openapi - OpenAPI 集成
hono/jsx - JSX 渲染
hono/websocket - WebSocket 支持

社区适配器

Firebase Functions
AWS Lambda
Supabase Functions
各种数据库和 ORM 集成

简单示例：完整的 API

import { Hono } from 'hono'
import { logger } from 'hono/logger'
import { cors } from 'hono/cors'
import { serve } from '@hono/node-server'

const app = new Hono()

// 中间件
app.use('*', logger())
app.use('/api/*', cors())

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

app.get('/api/users', async (c) => {
  const users = await db.users.findMany()
  return c.json(users)
})

app.post('/api/users', async (c) => {
  const data = await c.req.json()
  const user = await db.users.create({ data })
  return c.json(user, 201)
})

app.get('/api/users/:id', async (c) => {
  const id = c.req.param('id')
  const user = await db.users.findUnique({ where: { id } })
  return user ? c.json(user) : c.text('Not found', 404)
})

// 错误处理
app.onError((err, c) => {
  console.error(err)
  return c.json({ error: 'Internal Server Error' }, 500)
})

app.notFound((c) => {
  return c.text('Route not found', 404)
})

// 启动服务
if (import.meta.main) {
  serve(app, (info) => {
    console.log(`🚀 Server running on http://localhost:${info.port}`)
  })
}

export default app