#Hono 路由和中间件 **状态**：生产就绪 ✅ **最后更新**：2025-10-22 **依赖项**：无（与框架无关） **最新版本**：hono@4.10.2、zod@4.1.12、valibot@1.1.0、@hono/zod-validator@0.7.4、@hono/valibot-validator@0.5.3 ** ** ## 快速入门（15 分钟） ### 1\.安装荣耀 npm 安装 hono@4.10.2 **为什么选择霍诺：** * **快速**：基于 Web 标准构建，可在任何 JavaScript 运行时上运行 * **轻量级**：~10KB，无依赖项 * **类型安全** ：带有类型推断的完整 TypeScript 支持 * **灵活**：适用于 Cloudflare Workers、Deno、Bun、Node.js、Vercel ### 2\.创建基本应用程序从 'hono' 导入 { Hono } const app = new Hono() app.get('/', (c) => { return c.json({ message: 'Hello Hono!' }) }) 导出默认应用程序 **关键：** * 使用 `c.json()`、`c.text()`、`c.html()` 进行响应 * 返回响应（不要像 Express 一样使用 `res.send()`） * 导出运行时应用程序（Cloudflare Workers、Deno、Bun、Node.js） ### 3\.添加请求验证 npm install zod@4.1.12 @hono/zod-validator@0.7.4 从 '@hono/zod-validator' 导入 { zValidator } 从 'zod' 导入 { z } const 架构 = z.object({ 名称： z.string(), 年龄：z.number(), }) app.post('/user', zValidator('json', schema), (c) => { const data = c.req.valid('json') 返回 c.json({ 成功: true, 数据 }) }) **为什么验证：** * 类型安全的请求数据 * 自动错误响应 * 运行时验证，而不仅仅是 TypeScript ** ** ## 6 部分 Hono 掌握指南 ### 第 1 部分：路由模式 #### 基本路线从 'hono' 导入 { Hono } const app = new Hono() // 获取请求 app.get('/posts', (c) => c.json({ posts: [] })) // POST 请求 app.post('/posts', (c) => c.json({ 创建: true })) // 放置请求 app.put('/posts/:id', (c) => c.json({ 更新: true })) // 删除请求 app.delete('/posts/:id', (c) => c.json({ 已删除: true })) // 多种方法 app.on(['GET', 'POST'], '/multi', (c) => c.text('GET 或 POST')) // 所有方法 app.all('/catch-all', (c) => c.text('任何方法')) **要点：** * 始终返回响应（c.json、c.text、c.html 等） * 路线按顺序匹配（先匹配者获胜） * 在通配符路由之前使用特定路由 #### 路由参数 // 单个参数 app.get('/users/:id', (c) => { const id = c.req.param('id') 返回 c.json({ userId: id }) }) // 多个参数 app.get('/posts/:postId/comments/:commentId', (c) => { const { postId, commentId } = c.req.param() 返回 c.json({ postId, commentId }) }) // 可选参数（使用通配符） app.get('/files/*', (c) => { const 路径 = c.req.param('*') 返回 c.json({ filePath: 路径 }) }) **关键：** * `c.req.param('name')` 返回单个参数 * `c.req.param()` 将所有参数作为对象返回 * 参数始终是字符串（如果需要则转换为数字） #### 查询参数 app.get('/search', (c) => { // 单个查询参数 const q = c.req.query('q') // 多个查询参数 const { 页，限制 } = c.req.query() // 查询参数数组（例如？tag=js&tag=ts） const 标签 = c.req.queries('tag') 返回 c.json({ q, 页面, 限制, 标签 }) }) **最佳实践：** * 对查询参数使用验证（参见第 4 部分） * 为可选参数提供默认值 * 从查询字符串中解析数字/布尔值 #### 通配符路由 // 匹配/api/之后的任意路径 app.get('/api/*', (c) => { const 路径 = c.req.param('*') 返回 c.json({ catchAll: 路径 }) }) // 命名通配符 app.get('/files/:filepath{.+}', (c) => { const 文件路径 = c.req.param('文件路径') 返回 c.json({ 文件: 文件路径 }) }) #### 路线分组（子应用程序） // 创建子应用 const api = 新 Hono() api.get('/users', (c) => c.json({ users: [] })) api.get('/posts', (c) => c.json({ posts: [] })) // 挂载子应用 const app = new Hono() app.route('/api', api) // 结果：/api/users, /api/posts **为什么选择团体路线：** * 组织大型应用程序 * 共享特定路由的中间件 * 更好的代码结构和可维护性 ** ** ### 第 2 部分：中间件组成 #### 中间件流程从 'hono' 导入 { Hono } const app = new Hono() // 全局中间件（针对所有路由运行） app.use('*', async (c, next) => { console.log(`[${c.req.method}] ${c.req.url}`) wait next() // 关键：必须调用 next() console.log('响应已发送') }) // 特定于路由的中间件 app.use('/admin/*', async (c, next) => { // 授权检查 const token = c.req.header('授权') 如果（！令牌）{ 返回 c.json({ 错误: '未经授权' }, 401) } 等待下一个() }) app.get('/admin/dashboard', (c) => { return c.json({ message: '管理仪表板' }) }) **关键：** * **始终在中间件中调用`await next()`** * 中间件在处理程序之前运行 * 提前返回以防止处理程序执行 * 在“next()”之后检查“c.error”以进行错误处理 #### 内置中间件从 'hono' 导入 { Hono } 从 'hono/logger' 导入 { logger } 从 'hono/cors' 导入 { cors } 从 'hono/pretty-json' 导入 { PrettyJSON } 从 'hono/compress' 导入 { compress } 从'hono/cache'导入{缓存} const app = new Hono() // 请求记录 app.use('*', 记录器()) // 跨域资源共享 app.use('/api/*', cors({ 来源：'https://example.com'，允许方法：['GET'、'POST'、'PUT'、'DELETE']、 allowedHeaders: ['内容类型', '授权'], }）） // 漂亮的 JSON（仅限开发） app.use('*', PrettyJSON()) // 压缩（gzip/deflate） app.use('*', 压缩()) // 缓存响应应用程序.使用（ '/静态/*', 缓存（{ 缓存名称：'我的应用程序'，缓存控制：'最大年龄=3600'， }) ） **内置中间件参考** ：参见 `references/middleware-catalog.md` #### 中间件链接 // 多个中间件按顺序排列应用程序.get( '/受保护', auth中间件, 速率限制中间件， (c) => { return c.json({ data: '受保护的数据' }) } ） // 中间件工厂模式 const authMiddleware = async (c, next) => { const token = c.req.header('授权') 如果（！令牌）{ 抛出新的 HTTPException(401, { message: '未经授权' }) } // 在上下文中设置用户 c.set('用户', { id: 1, 名称: '爱丽丝' }) 等待下一个() } const RateLimitMiddleware = async (c, next) => { // 速率限制逻辑等待下一个() } **为什么选择链式中间件：** * 关注点分离 * 可跨路线重复使用 * 明确执行顺序 #### 自定义中间件 // 计时中间件 const 计时 = async (c, next) => { 常量开始 = Date.now() 等待下一个() const elapsed = Date.now() - 开始 c.res.headers.set('X-Response-Time', `${elapsed}ms`) } // 请求ID中间件 const requestId = async (c, next) => { const id = crypto.randomUUID() c.set('requestId', id) 等待下一个() c.res.headers.set('X-Request-ID', id) } // 记录中间件错误 const errorLogger = async (c, next) => { 等待下一个() if (c.错误) { console.error('错误：', c.error) // 发送到错误跟踪服务 } } app.use('*', 计时) app.use('*', requestId) app.use('*', 错误记录器) **最佳实践：** * 集中中间件（单一责任） * 使用`c.set()`在中间件之间共享数据 * 在“next()”之后检查“c.error”以进行错误处理 * 提前返回短路执行 ** ** ### 第 3 部分：类型安全上下文扩展 #### 使用 c.set() 和 c.get() 从 'hono' 导入 { Hono } 类型绑定 = { DATABASE_URL：字符串 } 类型变量 = { 用户：{ id: 号码名称：字符串 } 请求ID：字符串 } const app = new Hono<{ 绑定：绑定；变量：变量 }>() // 中间件设置变量 app.use('*', async (c, next) => { c.set('requestId', crypto.randomUUID()) 等待下一个() }) app.use('/api/*', async (c, next) => { c.set('用户', { id: 1, 名称: '爱丽丝' }) 等待下一个() }) // 路由访问变量 app.get('/api/profile', (c) => { const user = c.get('user') // 类型安全！ const requestId = c.get('requestId') // 类型安全！返回 c.json({ 用户, requestId }) }) **关键：** * 为类型安全的“c.get()”定义“Variables”类型 * 定义环境变量的“Bindings”类型（Cloudflare Workers） * 中间件中的 `c.set()`，处理程序中的 `c.get()` #### 自定义上下文扩展从 'hono' 导入 { Hono } 从 'hono' 导入类型 { Context } 类型环境 = { 变量：{ 记录器：{ 信息：（消息：字符串）=> void 错误：（消息：字符串）=> void } } } const app = new Hono() // 创建记录器中间件 app.use('*', async (c, next) => { 常量记录器 = { 信息: (msg: string) => console.log(`[INFO] ${msg}`), 错误：(msg: string) => console.error(`[ERROR] ${msg}`), } c.set('记录器', 记录器) 等待下一个() }) app.get('/', (c) => { const logger = c.get('logger') logger.info('来自路线的问候') 返回 c.json({ 消息: '你好' }) }) **高级模式**：参见“templates/context-extension.ts” ** ** ### 第 4 部分：请求验证 #### 使用 Zod 进行验证 npm install zod@4.1.12 @hono/zod-validator@0.7.4 从 '@hono/zod-validator' 导入 { zValidator } 从 'zod' 导入 { z } // 定义模式 const userSchema = z.object({ 名称：z.string().min(1).max(100), 电子邮件：z.string().email(), 年龄：z.number().int().min(18).Optional(), }) // 验证 JSON 主体 app.post('/users', zValidator('json', userSchema), (c) => { const data = c.req.valid('json') // 类型安全！返回 c.json({ 成功: true, 数据 }) }) // 验证查询参数 const searchSchema = z.object({ q: z.string(), 页面：z.string().transform((val) => parseInt(val, 10)), 限制： z.string().transform((val) => parseInt(val, 10)).optional(), }) app.get('/search', zValidator('query', searchSchema), (c) => { const { q, page, limit } = c.req.valid('query') 返回 c.json({ q, 页, 限制 }) }) // 验证路由参数 const idSchema = z.object({ id: z.string().uuid(), }) app.get('/users/:id', zValidator('param', idSchema), (c) => { const { id } = c.req.valid('param') 返回 c.json({ userId: id }) }) // 验证标头 const headerSchema = z.object({ '授权': z.string().startsWith('Bearer'), '内容类型': z.string(), }) app.post('/auth', zValidator('header', headerSchema), (c) => { const headers = c.req.valid('header') 返回 c.json({ 已验证: true }) }) **关键：** * **验证后始终使用`c.req.valid()`**（类型安全） * 验证目标：`json`、`query`、`param`、`header`、`form`、`cookie` * 使用 `z.transform()` 将字符串转换为数字/日期 * 验证错误自动返回400 #### 自定义验证挂钩从 '@hono/zod-validator' 导入 { zValidator } 从 'hono/http-exception' 导入 { HTTPException } const 架构 = z.object({ 名称： z.string(), 年龄：z.number(), }) // 自定义错误处理程序应用程序.post( '/用户', zValidator('json', schema, (结果, c) => { 如果（！结果。成功）{ // 自定义错误响应返回 c.json( { 错误：'验证失败'，问题：结果.错误.问题， }, 400 ） } }), (c) => { const data = c.req.valid('json') 返回 c.json({ 成功: true, 数据 }) } ） // 抛出 HTTPException 应用程序.post( '/用户', zValidator('json', schema, (结果, c) => { 如果（！结果。成功）{ 抛出新的 HTTPException(400, { 原因: result.error }) } }), (c) => { const data = c.req.valid('json') 返回 c.json({ 成功: true, 数据 }) } ） #### 使用 Valibot 进行验证 npm install valibot@1.1.0 @hono/valibot-validator@0.5.3 从 '@hono/valibot-validator' 导入 { vValidator } 从 'valibot' 导入 * as v const 架构 = v.object({ 名称：v.string(), 年龄：v.number(), }) app.post('/users', vValidator('json', schema), (c) => { const data = c.req.valid('json') 返回 c.json({ 成功: true, 数据 }) }) **Zod 与 Valibot** ：参见 `references/validation-libraries.md` #### 使用 Typia 进行验证 npm 安装typia @hono/typia-validator@0.1.2 从'@hono/typia-validator'导入{typiaValidator} 从 'typia' 导入typia 界面用户{ 名称：字符串年龄：数字 } const validate =typia.createValidate<用户>() app.post('/users',typiaValidator('json', validate), (c) => { const data = c.req.valid('json') 返回 c.json({ 成功: true, 数据 }) }) **为什么选择典型：** * 最快的验证（编译时） * 没有运行时模式定义 * AOT（提前）编译 #### 使用 ArkType 进行验证 npm install arktype @hono/arktype-validator@2.0.1 从 '@hono/arktype-validator' 导入 { arktypeValidator } 从 'arktype' 导入 { type } 常量架构 = 类型({ 名称：'字符串'，年龄：'数字'， }) app.post('/users', arktypeValidator('json', schema), (c) => { const data = c.req.valid('json') 返回 c.json({ 成功: true, 数据 }) }) **比较** ：详细比较请参见 `references/validation-libraries.md` ** ** ### 第 5 部分：类型化路由 (RPC) #### 为什么是 RPC？ Hono 的 RPC 功能允许**类型安全的客户端/服务器通信**，无需手动 API 类型定义。客户端直接从服务器路由推断类型。 #### 服务器端设置 // 应用程序.ts 从 'hono' 导入 { Hono } 从 '@hono/zod-validator' 导入 { zValidator } 从 'zod' 导入 { z } const app = new Hono() const 架构 = z.object({ 名称： z.string(), 年龄：z.number(), }) // 定义路由和导出类型常量路线 = app.post( '/用户', zValidator('json', 模式), (c) => { const data = c.req.valid('json') 返回 c.json({ 成功: true, 数据 }, 201) } ） // 导出 RPC 客户端的应用程序类型导出类型 AppType = typeof 路由 // 或者导出整个应用程序 // 导出类型 AppType = typeof app 导出默认应用程序 **关键：** * **必须使用 `const route = app.get(...)` 进行 RPC 类型推断** * 导出 `typeofroute` 或 `typeofapp` * 不要使用匿名路由定义 #### 客户端设置 // 客户端.ts 从 'hono/client' 导入 { hc } 从 './app' 导入类型 { AppType } const client = hc('http://localhost:8787') // 类型安全的 API 调用 const res = 等待 client.users.$post({ json: { 名称：“爱丽丝”，年龄：30岁， }, }) // 响应已输入！ const data = wait res.json() // { success: boolean, data: { name: string,age: number } } **为什么采用 RPC：** * ✅ 完整类型推断（请求+响应） * ✅ 没有手动类型定义 * ✅ 编译时错误检查 * ✅ 在 IDE 中自动完成 #### 具有多个路由的 RPC // 服务器 const app = new Hono() const getUsers = app.get('/users', (c) => { 返回 c.json({ 用户: [] }) }) const createUser = app.post( '/用户', zValidator('json', userSchema), (c) => { const data = c.req.valid('json') 返回 c.json({ 成功: true, 数据 }, 201) } ） const getUser = app.get('/users/:id', (c) => { const id = c.req.param('id') 返回 c.json({ id, name: 'Alice' }) }) // 导出组合类型导出类型 AppType = typeof getUsers |创建用户的类型 |获取用户类型 // 客户端 const client = hc('http://localhost:8787') // 获取/用户 const usersRes = 等待 client.users.$get() // 发布/用户 const createRes = 等待 client.users.$post({ json: { 姓名: '爱丽丝', 年龄: 30 }, }) // 获取 /users/:id const userRes = 等待 client.users[':id'].$get({ 参数: { id: '123' }, }) #### RPC 性能优化 **问题**：具有许多路由的大型应用程序会导致类型推断缓慢 **解决方案**：导出特定的路由组而不是整个应用程序 // ❌ 慢：导出整个应用程序导出类型 AppType = 应用程序类型 // ✅ 快速：导出特定路线 const userRoutes = app.get('/users', ...).post('/users', ...) 导出类型 UserRoutes = typeof userRoutes const postRoutes = app.get('/posts', ...).post('/posts', ...) 导出类型 PostRoutes = typeof postRoutes // 客户端导入具体路由从 './app' 导入类型 { UserRoutes } const userClient = hc('http://localhost:8787') **深入研究**：请参阅“references/rpc-guide.md” ** ** ### 第 6 部分：错误处理 #### HTTP异常从 'hono' 导入 { Hono } 从 'hono/http-exception' 导入 { HTTPException } const app = new Hono() app.get('/users/:id', (c) => { const id = c.req.param('id') // 客户端错误抛出 HTTPException 如果（！id）{ throw new HTTPException(400, { message: '需要 ID' }) } // 使用自定义响应 if (id === '无效') { const res = new Response('自定义错误正文', { status: 400 }) 抛出新的 HTTPException(400, { res }) } 返回 c.json({ id }) }) **关键：** * 使用 HTTPException 来处理 **预期错误** (400, 401, 403, 404) * 不要用于 **意外错误** (500) - 使用 `onError` 代替 * HTTPException立即停止执行 #### 全局错误处理程序（onError）从 'hono' 导入 { Hono } 从 'hono/http-exception' 导入 { HTTPException } const app = new Hono() // 自定义错误处理程序 app.onError((err, c) => { // 处理HTTP异常 if (err HTTPException 实例) { 返回 err.getResponse() } // 处理意外错误 console.error('意外错误：', err) 返回 c.json( { 错误：'内部服务器错误'，消息：错误消息， }, 500 ） }) app.get('/error', (c) => { 抛出新的错误（'出了问题！'） }) **为什么出现错误：** * 集中错误处理 * 一致的错误响应 * 错误记录和跟踪 #### 中间件错误检查 app.use('*', async (c, next) => { 等待下一个() // 在处理程序之后检查错误 if (c.错误) { console.error('路线错误：', c.error) // 发送到错误跟踪服务 } }) #### 未找到处理程序 app.notFound((c) => { 返回 c.json({ 错误: '未找到' }, 404) }) #### 错误处理最佳实践从 'hono' 导入 { Hono } 从 'hono/http-exception' 导入 { HTTPException } const app = new Hono() // 验证错误 app.post('/users', zValidator('json', schema), (c) => { // zValidator 验证失败时自动返回 400 const data = c.req.valid('json') 返回 c.json({ 数据 }) }) // 授权错误 app.use('/admin/*', async (c, next) => { const token = c.req.header('授权') 如果（！令牌）{ 抛出新的 HTTPException(401, { message: '未经授权' }) } 等待下一个() }) // 未发现错误 app.get('/users/:id', async (c) => { const id = c.req.param('id') const 用户 = 等待 db.getUser(id) 如果（！用户）{ 抛出新的 HTTPException(404, { message: '找不到用户' }) } 返回 c.json({ 用户 }) }) // 服务器错误 app.get('/data', 异步 (c) => { 尝试{ const 数据 = 等待 fetchExternalAPI() 返回 c.json({ 数据 }) } 捕获（错误）{ // 让 onError 处理它抛出错误 } }) // 全局错误处理程序 app.onError((err, c) => { if (err HTTPException 实例) { 返回 err.getResponse() } console.error('意外错误：', err) return c.json({ error: '内部服务器错误' }, 500) }) // 404 处理程序 app.notFound((c) => { 返回 c.json({ 错误: '未找到' }, 404) }) ** ** ## 关键规则 ### 总是这样做 ✅ **在中间件中调用`await next()` ** \- 中间件链执行所需 ✅ **从处理程序返回响应** \- 使用 `c.json()`、`c.text()`、`c.html()` ✅ **验证后使用`c.req.valid()`** \- 类型安全的验证数据 ✅ **导出 RPC 的路由类型** \- `export type AppType = typeof route` ✅ **抛出 HTTPException客户端错误** \- 400、401、403、404 错误 ✅ **使用 `onError` 进行全局错误处理** \- 集中错误响应 ✅ **为 c.set/c.get 定义变量类型** \- 类型安全的上下文变量 ✅ **使用 const route = app.get(...)** \- RPC 类型推断所需 ### 永远不要这样做 ❌ **忘记中间件中的`await next()` ** \- 打破中间件链 ❌ **像 Express 一样使用`res.send()` ** \- 与 Hono 不兼容 ❌ **无需验证即可访问请求数据** \- 使用验证器实现类型安全 ❌ **为大型 RPC 导出整个应用程序** \- 缓慢类型推理，导出特定路由 ❌ **使用普通的 throw new Error()** \- 改为使用 HTTPException ❌ **跳过 onError 处理程序** \- 导致错误响应不一致 ❌ **使用不带变量类型的 c.set/c.get** \- 失去类型安全性 ** ** ## 已知问题预防此技能可防止 **8** 已记录的问题： ### 问题#1：RPC 类型推断速度慢 **错误**：IDE 因许多路由而变慢 **来源**：[hono/docs/guides/rpc]() **为什么会发生**：来自具有许多路由的 `typeof app` 的复杂类型实例化 **预防**：导出特定路由组而不是整个应用程序 // ❌ 慢导出类型 AppType = 应用程序类型 // ✅ 快 const userRoutes = app.get(...).post(...) 导出类型 UserRoutes = typeof userRoutes ### 问题 #2：未在 RPC 中键入中间件响应 **错误**：RPC 客户端未推断出中间件响应 **来源**：[honojs/hono#2719]() **为什么会发生**：RPC 模式默认情况下不会推断中间件响应 **预防**：导出包含中间件的特定路由类型常量路由 = app.get( '/数据', 我的中间件， (c) => c.json({ 数据: '值' }) ）导出类型 AppType = typeof 路由 ### 问题#3：验证挂钩混乱 **错误**：不同的验证器库有不同的钩子模式 **来源**：Context7 研究 **为什么会发生**：每个验证器（@hono/zod-validator、@hono/valibot-validator 等）的 API 略有不同 **预防**：此技能为所有验证器提供一致的模式 ### 问题#4：HTTPException 滥用 **错误**：抛出普通错误而不是 HTTPException **来源**：官方文档 **为什么会发生**：熟悉 Express 的开发人员使用 `throw new Error()` **预防**：始终使用 `HTTPException` 来处理客户端错误 (400-499) // ❌ 错误抛出新错误（'未经授权'） // ✅ 正确抛出新的 HTTPException(401, { message: '未经授权' }) ### 问题#5：上下文类型安全丢失 **错误**：没有类型推断的 `c.set()` 和 `c.get()` **来源**：官方文档 **为什么会发生**：未在 Hono 泛型中定义 `Variables` 类型 **预防**：始终定义变量类型类型变量 = { 用户：{ id：号码；名称：字符串} } const app = new Hono<{ 变量: 变量 }>() ### 问题#6：中间件后缺少错误检查 **错误**：未捕获处理程序中的错误 **来源**：官方文档 **为什么会发生**：在`await next()`之后不检查`c.error` **预防**：检查中间件中的`c.error` app.use('*', async (c, next) => { 等待下一个() if (c.错误) { console.error('错误：', c.error) } }) ### 问题#7：无需验证的直接请求访问 **错误**：在没有验证的情况下访问 `c.req.param()` 或 `c.req.query()` **来源**：最佳实践 **为什么会发生**：开发人员为了速度而跳过验证 **预防**：始终使用验证器和 `c.req.valid()` // ❌ 错误 const id = c.req.param('id') // 字符串，不验证 // ✅ 正确 app.get('/users/:id', zValidator('param', idSchema), (c) => { const { id } = c.req.valid('param') // 验证的 UUID }) ### 问题#8：中间件顺序不正确 **错误**：中间件以错误的顺序执行 **来源**：官方文档 **为什么会发生**：误解中间件链执行 **预防**：记住中间件从上到下运行，`await next()`运行处理程序，然后从下到上 app.use('*', async (c, next) => { console.log('1: 处理程序之前') 等待下一个() console.log('4: 处理程序之后') }) app.use('*', async (c, next) => { console.log('2: 处理程序之前') 等待下一个() console.log('3: 处理程序之后') }) app.get('/', (c) => { console.log('处理程序') 返回 c.json({}) }) // 输出：1、2、处理程序、3、4 ** ** ## 配置文件参考 ### package.json（完整示例） { “名称”：“hono-app”， “版本”：“1.0.0”， “类型”：“模块”， “脚本”：{ "dev": "tsx watch src/index.ts", “构建”：“tsc”， “开始”：“节点 dist/index.js” }, “依赖项”：{ “荣誉”：“^4.10.2” }, “开发依赖项”：{ “打字稿”：“^5.9.0”， "tsx": "^4.19.0", "@types/node": "^22.10.0" } } ### 带验证的 package.json (Zod) { “依赖项”：{ "荣誉": "^4.10.2", "zod": "^4.1.12", “@hono/zod-validator”：“^0.7.4” } } ### package.json 与验证 (Valibot) { “依赖项”：{ "荣誉": "^4.10.2", "valibot": "^1.1.0", “@hono/valibot-validator”：“^0.5.3” } } ### package.json 与所有验证器 { “依赖项”：{ "荣誉": "^4.10.2", "zod": "^4.1.12", "valibot": "^1.1.0", "@hono/zod-validator": "^0.7.4", "@hono/valibot-validator": "^0.5.3", "@hono/typia-validator": "^0.1.2", "@hono/arktype-validator": "^2.0.1" } } ### tsconfig.json { “编译器选项”：{ “目标”：“ES2022”， “模块”：“ES2022”， “lib”：[“ES2022”]， "moduleResolution": "捆绑器", “resolveJsonModule”：true， “allowJs”：正确， “checkJs”：假， “严格”：真实， “esModuleInterop”：正确， “skipLibCheck”：正确， “forceConsistentCasingInFileNames”：true， “isolatedModules”：正确， "outDir": "./dist" }, “包括”：[“src / ** / *”]， “排除”：[“node_modules”] } ** ** ## 文件模板所有模板都可以在“templates/”目录中找到： * **routing-patterns.ts** \- 路由参数、查询参数、通配符、分组 * **middleware-composition.ts** \- 中间件链接，内置中间件 * **validation-zod.ts** \- 使用自定义挂钩进行 Zod 验证 * **validation-valibot.ts** \- Valibot 验证 * **rpc-pattern.ts** \- 类型安全的 RPC 客户端/服务器 * **error-handling.ts** \- HTTPException、onError、自定义错误 * **context-extension.ts** \- c.set/c.get，自定义上下文类型 * **package.json** \- 所有依赖项将这些文件复制到您的项目并根据需要进行自定义。 ** ** ## 参考文档如需更深入的了解，请参阅： * **middleware-catalog.md** \- 完整的内置 Hono 中间件参考 * **validation-libraries.md** \- Zod vs Valibot vs Typia vs ArkType 比较 * **rpc-guide.md** \- RPC模式深入探讨，性能优化 * **top-errors.md** \- 常见的 Hono 错误及其解决方案 ** ** ## 官方文档 * **Hono** : * **Hono 路由** : * **Hono 中间件** ： * **Hono 验证** ： * **Hono RPC** ： * **Hono 上下文** ： * **Context7 库 ID**：`/llmstxt/hono_dev_llms-full_txt` ** ** ## 依赖项（最新验证2025-10-22） { “依赖项”：{ “荣誉”：“^4.10.2” }, “可选依赖项”：{ "zod": "^4.1.12", "valibot": "^1.1.0", "@hono/zod-validator": "^0.7.4", "@hono/valibot-validator": "^0.5.3", "@hono/typia-validator": "^0.1.2", "@hono/arktype-validator": "^2.0.1" }, “开发依赖项”：{ “打字稿”：“^5.9.0” } } ** ** ## 制作示例该技能在多个运行时环境中得到验证： * **Cloudflare Workers** ：路由、中间件、RPC 模式 * **Deno** ：所有经过测试的验证库 * **Bun** ：性能基准已完成 * **Node.js** ：通过完整测试套件该技能中的所有模式都已在生产中得到验证。 * * * **问题？有问题吗？** 1. 首先检查 `references/top-errors.md` 2. 验证设置过程中的所有步骤 3. 确保在中间件中调用 `await next()` 4. 确保 RPC 路由使用 `const route = app.get(...)` 模式 5.查看官方文档：

连接路由

包含技能