古法编程

使用 Hono 构建超快速的 Edge API 和全栈应用

解决跨运行时部署痛点：通过 Hono 框架实现一套代码在 Cloudflare Workers、Bun、Deno 和 Node.js 等多种环境下无缝运行，并提供极致的路由性能与端到端类型安全。

为什么需要这个技能

在现代 Web 开发中，开发者经常需要在传统的 Node.js 服务器和边缘计算（Edge Computing）之间做选择。传统的框架（如 Express）虽然成熟，但体积庞大且不完全兼容 Web 标准，难以直接运行在 Cloudflare Workers 等边缘运行时中。

Hono（日语中意为“炎”）基于 Web 标准（Request/Response/fetch）构建，体积极小且速度极快。它不仅解决了环境兼容性问题，还通过强大的 TypeScript 集成和 RPC 模式，消除了前后端接口定义不一致的痛点。

适用场景

  • 边缘 API 部署：在 Cloudflare Workers 或 Deno Deploy 上构建低延迟的 REST/RPC API。
  • BFF 层构建：为前端提供一个轻量级的后端适配层。
  • 高性能轻量服务端：在 Bun 或 Node.js 中替代 Express 寻求更好的类型支持。
  • 全栈类型同步：利用 Hono 的 RPC 客户端实现前端调用后端的全链路类型检查。

核心工作流

1. 环境初始化

针对不同运行时选择初始化方式。以 Cloudflare Workers 为例：

npm create hono@latest my-api
# 选择 cloudflare-workers
cd my-api
npm install
npm run dev

2. 路由与中间件构建

Hono 采用链式路由，支持强大的内置中间件（如 logger, cors, jwt）。

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

const app = new Hono();
app.use('*', logger());

app.get('/posts/:id', async c => {
  const id = c.req.param('id');
  return c.json({ id, title: 'Hello Hono!' });
});

3. 输入校验（Zod 集成）

使用 @hono/zod-validator 确保请求数据的类型安全，防止非法请求进入业务逻辑。

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

const schema = z.object({ title: z.string().min(1) });

app.post('/posts', zValidator('json', schema), async c => {
  const data = c.req.valid('json'); 
  return c.json({ success: true }, 201);
});

4. 端到端 RPC 调用

导出服务器端的路由类型，在客户端使用 hc 客户端实现无需定义接口文档的自动补全。

// Server: 导出类型
export type AppType = typeof app;

// Client: 获得全量类型提示
import { hc } from 'hono/client';
import type { AppType } from './server';

const client = hc<AppType>('https://api.example.com');
const res = await client.posts['$post']({ json: { title: 'New Post' } }).json();

下载和安装

下载 hono 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要

暂无推荐