Elysia 教程简介

欢迎来到 Elysia 教程!

什么是 Elysia?

ElysiaJS 是一个专为 Bun 运行时设计的、符合人体工程学且性能极高的 Web 框架。

如果你熟悉 Express.js 或 Fastify,你可以把 Elysia 想象成它们在 Bun 生态系统中的超强进化版。

为什么选择 Elysia?

  1. 专为 Bun 打造:Elysia 充分利用了 Bun 的底层 API 和性能优势,在各种基准测试(Benchmarks)中,它的速度远远超过了运行在 Node.js 上的 Express,甚至是 Fastify。
  2. 极致的类型安全 (End-to-End Type Safety):这是 Elysia 的杀手级特性。通过与 TypeBox(或 Sinclair/TypeBox)的深度集成,Elysia 允许你用 TypeScript 极其简单地定义 API 的输入和输出。不仅提供了运行时的参数校验,还能自动推导出前后端共享的类型。
  3. Eden (端到端类型客户端):配合 Elysia 的 Eden 客户端,你在前端(如 React 或 Vue)发起 fetch 请求时,可以直接获得后端 API 的完整类型提示、自动补全,以及拼写错误检查。你甚至不需要生成 Swagger 或 OpenAPI 文档!
  4. 插件生态:内置或提供了丰富的官方插件,如 JWT, Swagger, CORS, WebSocket, GraphQL 等。

本教程将包含什么?

本教程旨在带你从零开始掌握 ElysiaJS 并构建一个高性能的后端 API:

  1. Elysia 的安装与基础路由配置。
  2. 请求参数的处理(Params, Query, Body)。
  3. 深入理解 TypeBox 模式验证(Schema Validation)。
  4. 中间件(Hooks)机制:如 beforeHandle, afterHandle, onError
  5. 状态管理(State, Decorate)与依赖注入思想。
  6. Eden 客户端:在前端项目中无缝调用你的 API 并享受极致的类型提示。
  7. 结合 Prisma / Drizzle 等 ORM 操作数据库。

本文为轻叶全栈手册原创内容,转载请注明出处。