Hono 本地开发指南
使用 Hono 编写轻量 Web API 与边缘服务，Node.js 本地默认 localhost:3000，亦可部署到 Cloudflare Workers。
Hono 是 ultrafast 的 Web 框架，API 简洁、体积极小，可在 Cloudflare Workers、Deno、Bun、Node.js 等多运行时运行。适合 REST API、BFF 层与边缘函数。
快速开始（Node.js）
npm create hono@latest my-app
cd my-app
npm install
npm run dev选择 nodejs 或 cloudflare-workers 模板均可。
默认 localhost 访问
| 用途 | 地址 |
|---|---|
| Node 开发服务器 | http://localhost:3000 |
| Cloudflare Workers 本地 | http://localhost:8787（wrangler dev） |
Node 模板可在入口文件中修改 serve({ fetch: app.fetch, port: 3000 }) 的端口。
常用命令
| 命令 | 说明 |
|---|---|
npm run dev | 本地开发（依模板为 Node 或 Wrangler） |
wrangler dev | Workers 本地模拟（Cloudflare 模板） |
wrangler deploy | 部署到 Cloudflare Workers |
最小示例
import { Hono } from 'hono';
const app = new Hono();
app.get('/', (c) => c.json({ message: 'Hello from localhost!' }));
app.get('/api/health', (c) => c.json({ ok: true }));
export default app;适用场景
- 轻量 REST / JSON API
- 与前端 SPA 联调（localhost 同源或 CORS）
- 边缘部署：低延迟、全球分布
小结
Hono 本地 Node 开发通常访问 **http://localhost:3000**，Workers 模式为 **http://localhost:8787**，适合快速搭建 API 与边缘服务。