该技能用于指导使用 ElysiaJS 开发类型安全、高性能的后端服务。框架以 Bun 为优先运行时,但不限于 Bun,同样可运行于 Node.js、Deno 等环境。使用前建议查阅 elysiajs.com/llms.txt 获取最新 API 与示例。
适用场景包括:创建或修改路由、handler 与服务器;使用 TypeBox 或 Zod、Valibot 等标准 Schema 做输入输出校验;实现 JWT、会话、macro、guard 等鉴权方式;添加 CORS、OpenAPI、静态文件、JWT 等官方插件;集成 Drizzle ORM、Better Auth、Next.js、Eden Treaty 等外部服务;搭建 WebSocket 实时端点;编写单元测试;部署到生产环境。
基本用法:可用 bun create elysia app 快速脚手架。核心是链式调用创建 Elysia 实例并注册 HTTP 方法(get、post、put、patch、delete、options、head),在上下文中解构 params、query、body、headers 等。校验通过 t.Object、t.String、t.Number、t.Optional、t.Array、t.File、t.Files 等描述请求体、路径参数、查询与响应,未匹配错误可用 status 返回自定义状态码;也可用 Zod 等标准 Schema。guard 可对多路由批量应用校验,macro 可组合可复用的 schema 与生命周期钩子。
关键概念:封装默认隔离生命周期,作用域分 local、scoped、global;必须链式调用以保持类型推断;实例间依赖需显式 use 声明;命名插件可避免重复执行;事件只对注册在其后的路由生效;类型推断依赖内联函数;模型可按名称引用并支持 prefix/suffix。推荐按功能与领域划分目录,将 controller、service、model 分离。
限制与说明:资料未提供具体收费标准或价格信息;性能与部署效果的具体数据暂未提供。