Elysia 教程简介
欢迎来到 Elysia 教程!
什么是 Elysia?
ElysiaJS 是一个专为 Bun 运行时设计的、符合人体工程学且性能极高的 Web 框架。
如果你熟悉 Express.js 或 Fastify,你可以把 Elysia 想象成它们在 Bun 生态系统中的超强进化版。
为什么选择 Elysia?
- 专为 Bun 打造:Elysia 充分利用了 Bun 的底层 API 和性能优势,在各种基准测试(Benchmarks)中,它的速度远远超过了运行在 Node.js 上的 Express,甚至是 Fastify。
- 极致的类型安全 (End-to-End Type Safety):这是 Elysia 的杀手级特性。通过与
TypeBox(或Sinclair/TypeBox)的深度集成,Elysia 允许你用 TypeScript 极其简单地定义 API 的输入和输出。不仅提供了运行时的参数校验,还能自动推导出前后端共享的类型。 - Eden (端到端类型客户端):配合 Elysia 的 Eden 客户端,你在前端(如 React 或 Vue)发起 fetch 请求时,可以直接获得后端 API 的完整类型提示、自动补全,以及拼写错误检查。你甚至不需要生成 Swagger 或 OpenAPI 文档!
- 插件生态:内置或提供了丰富的官方插件,如 JWT, Swagger, CORS, WebSocket, GraphQL 等。
本教程将包含什么?
本教程旨在带你从零开始掌握 ElysiaJS 并构建一个高性能的后端 API:
- Elysia 的安装与基础路由配置。
- 请求参数的处理(Params, Query, Body)。
- 深入理解 TypeBox 模式验证(Schema Validation)。
- 中间件(Hooks)机制:如
beforeHandle,afterHandle,onError。 - 状态管理(State, Decorate)与依赖注入思想。
- Eden 客户端:在前端项目中无缝调用你的 API 并享受极致的类型提示。
- 结合 Prisma / Drizzle 等 ORM 操作数据库。
本文为轻叶全栈手册原创内容,转载请注明出处。

