项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-09-14 · 当前星标 ★ 1836
使用教程
环境要求
- Node.js 环境（需能使用 npx / npm）
- 包管理器 bun、pnpm 或 npm 任选其一
- 一份要被转换成代码的 OpenAPI/Swagger schema
- 项目目录（可为空目录，向导会在需要时创建 package.json）
安装与启动步骤
-
1安装 kubb
在项目目录中用你惯用的包管理器安装 kubb，三种命令任选其一即可。
npm install kubb -
2运行初始化向导
向导会按需创建 package.json，引导你选择插件、安装对应依赖，并写出 kubb.config.ts。
npx kubb init -
3生成代码
执行生成命令，按 kubb.config.ts 中的配置从 schema 产出类型、客户端、hooks、校验器、mock 等文件。
npx kubb generate -
4查阅进阶用法
README 只给出安装与快速开始，插件组合与高级配置请到官网文档查看。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
kubb.config.ts | 是 | 由 init 向导生成的配置文件，定义输入 schema 与所选插件 | kubb.config.ts |
如何确认成功
执行 npx kubb generate 后终端无报错，并按所选插件生成对应的 TypeScript 代码文件。
常见问题
Q：该用哪个包管理器安装？
A：README 给出了三种方式：bun add kubb、pnpm add kubb、npm install kubb，按你项目现有工具链任选其一即可。
Q：项目里还没有 package.json 怎么办？
A：不需要手动准备，kubb init 向导会在需要时自动创建 package.json，再继续引导插件选择。
Q：怎么选择生成哪些产物？
A：由 init 向导引导你选择插件，插件决定生成类型、客户端、hooks、Zod 校验、Faker mock、MSW handlers 等产物。
Q：生成命令有哪些参数？
A：README 只给出了 npx kubb generate 这一条基础命令，更多参数与高级特性请查阅官方文档 https://kubb.dev。
注意事项
- npx kubb init 会自动安装所选插件所需的依赖包，执行前请确认网络可用。
- 首次运行会写入 kubb.config.ts，建议将该文件纳入版本管理。
- README 未提供插件配置的具体写法，实际配置请以 https://kubb.dev 文档为准。
核心亮点
- 插件化架构，可按需组合类型、Zod、Query、MSW 等生成器，不绑定单一技术栈
- 同时覆盖 React/Vue/Svelte/Solid 及 TanStack Query、SWR，框架适配面广
- 从 OpenAPI 单一来源生成类型与校验，减少手写接口代码和文档漂移
不足之处
- 插件组合灵活但配置概念较多，新手上手成本偏高
- 生态与社区规模仍小于 OpenAPI Generator 等成熟方案，边缘场景文档待完善
适用场景
- 前端团队根据后端 OpenAPI 文档自动生成类型安全的请求 hooks 和校验逻辑
- 全栈项目用同一份规范生成 Zod schema，前后端共享运行时校验
- 测试环境用 Kubb 生成 MSW mock 和 Faker 假数据，快速搭建接口模拟
替代项目
OpenAPI Generator、orval、openapi-typescript
上一篇：ml-diffucoder
下一篇：cog
同类项目推荐
codegen
开源
用聊天生成代码，快速验证你的编程想法
Salesforce codegen with web server
dev-quality-gates
开源
每个环节只推一个工具，快速搭起代码质量门禁
An opinionated, curated list of tools for enforcing software development standards: ···
lumen
开源
终端里看 diff、写提交，AI 帮你搞定
Beautiful git diff viewer, generate commits with AI, get summary of changes, all fro···
VibeGit
开源
给 AI 改代码加个后悔键，随时回滚不慌
Local-first desktop safety net for AI-assisted coding. Create checkpoints, inspect c···
OdinRunes
开源
在编辑器里直接调教 GPT，自动提取上下文，省心省钱。
Odin Runes, a java-based GPT client, facilitates interaction with your preferred GPT···
token-saver
开源
压缩CLI输出60-99%，让AI编程助手少烧token
Content-aware output compression for AI coding assistants. 36 specialized processors···
lsp-ai
开源
在任意 LSP 编辑器里接入 AI 补全和解释，无需切换工具
LSP-AI is an open-source language server that serves as a backend for AI-powered fun···
aider-desk
开源
把 AI 编程从单打独斗变成团队流水线，任务可追踪、结果可审查。
Platform for AI-powered software engineers
claude-ctrl
开源
早期浏览器自动化操控 Claude 的脚本工具，现已废弃
DEPRECATED / UNMAINTAINED — historical reference only. Do not install or rely on th···