该技能面向使用 Fastify 5.x 与 TypeScript 构建后端 API,并运行在 Bun 运行时上的开发场景。技术栈包括:Bun(运行时、包管理器、测试运行器与 watch 模式开发服务器,不使用 Node.js、npm 或 tsx)、Fastify 5.x、TypeScript、pino-pretty 日志、@fastify/env 环境变量校验、@fastify/cors 跨域支持、fastify-plugin 插件系统。Bun 直接执行 TypeScript 源码,开发与生产均无编译步骤,tsc 仅作类型检查(tsc --noEmit)。
主要能力与用法:用 asdf 管理 Bun 版本(asdf plugin add bun;asdf set bun latest;asdf install),生成 .tool-versions 固定版本。常用命令:bun run dev(bun --watch src/index.ts)、bun run check(tsc --noEmit)、bun run start(bun run src/index.ts)、bun test。依赖管理统一用 bun add / bun add -d / bun remove,并提交 bun.lock。配置须通过 fastify.config 访问而非 process.env。提供标准响应结构(success、data、error、metadata)、插件模式、路由模式与服务类模式(含模块增强与 decorate)。项目结构含 plugins、routes、services、lib、app.ts、index.ts。
参考文件覆盖新项目搭建、路由与服务实现、JWT 认证、Swagger/OpenAPI 与错误格式、MCP 集成、常见问题排查。注意事项:插件注册顺序为 env、服务、路由;index.ts 中访问配置前需 await server.ready();无构建步骤;路径工具集中管理。具体收费、平台与效果信息暂未提供。