VentoStack 简介

VentoStack 是一个专为 Bun 运行时构建的全栈后端框架。它采用函数式优先的设计理念，提供了构建现代 Web 应用所需的完整工具集。

设计理念

函数式优先

VentoStack 摒弃了传统 Node.js 框架中常见的类和装饰器模式，转而采用工厂函数（Factory Function）模式：

// 不使用类
class Router { ... }
new Router().get(...)

// VentoStack 的方式 - 工厂函数
const router = createRouter()
router.get('/path', handler)

这种方式带来以下优势：

• 代码更易测试（无需 new 和继承）
• 更好的 TypeScript 类型推断
• 无副作用，依赖显式传入
• 更容易进行函数组合

显式依赖

所有依赖通过参数显式传入，没有全局单例：

// 不使用全局单例
import db from './global-db'

// VentoStack 的方式 - 显式依赖
const app = createApp({ port: 3000 })
const db = createQueryBuilder({ url: process.env.DATABASE_URL! })
const cache = createCache({ adapter: createMemoryAdapter() })

Bun 原生

VentoStack 充分利用 Bun 的内置能力：

• Bun.serve() 作为 HTTP 服务器底层
• Bun.sqlite 用于嵌入式数据库
• Bun.file() 用于文件 I/O
• Bun.password 用于安全密码哈希

包结构

包名	说明
@ventostack/core	HTTP 应用、路由、中间件、错误处理、配置
@ventostack/database	查询构建器、迁移、连接池、事务
@ventostack/cache	缓存层，支持内存和 Redis 适配器
@ventostack/auth	JWT、RBAC、OAuth、会话、MFA
@ventostack/events	事件总线、消息队列、事件溯源
@ventostack/observability	日志、指标、追踪、告警
@ventostack/openapi	OpenAPI 3.1 schema 生成和请求验证
@ventostack/testing	测试工具、Mock 辅助
@ventostack/ai	LLM 适配器、RAG、流式响应
@ventostack/cli	脚手架和代码生成工具

为什么选择 VentoStack？

vs Express/Fastify

Express 和 Fastify 为 Node.js 设计，在 Bun 上运行有兼容性开销。VentoStack 直接基于 Bun.serve() 构建，性能更优。

vs Hono

Hono 是优秀的轻量框架，但功能单一。VentoStack 提供完整的生态，包括数据库、缓存、认证等一站式解决方案。

vs NestJS

NestJS 依赖装饰器和复杂的依赖注入系统，学习曲线陡峭。VentoStack 采用简单的函数组合，上手更快。