官网 | 文档 | 社区 | Bit Cloud

Bit 是一款在 AI 时代将组件与应用从开发阶段无缝连接到 CI 的构建系统。Bit 将源代码组织成可组合的组件，助力开发者构建可靠、可扩展且一致的应用程序。它使 AI 代理能够通过 MCP 智能地创建和复用组件，从而避免重复劳动并加速开发进程。

⚡ 功能特性

• 可复用组件。 创建可在整个软件中复用的 UI 组件和模块。
• 标准构建块。 定义用于为开发者和 AI 生成组件的蓝图模板。
• 壳层应用。 将可复用的组件和功能组合成应用壳层。
• 原子化且安全的部署。 确保应用和服务在测试和生产环境中的简单、安全及优化部署。

Bit 支持 JavaScript 生态系统中的所有工具，并开箱即用地提供针对 NodeJS、React、Angular、Vue、React Native、NextJS 以及更多框架的官方开发环境。这些环境原生支持 TypeScript 和 ESM，并配备了最佳的开发工具链。

Bit 适用于任何代码库结构。你可以在单体仓库、多仓库甚至无仓库的情况下使用 Bit 组件。

开始使用

安装 Bit

使用 Bit 安装程序将 Bit 安装到你的 PATH 中：

npx @teambit/bvm install

在新文件夹或现有项目中初始化 Bit，运行以下命令：

bit init --default-scope my-org.my-project

请务必在 Bit 平台上创建你的作用域，并使用正确的组织和项目名称。执行该命令后，Bit 就会在选定目录中初始化完毕，你可以通过 Bit 命令、AI 代理、编辑器插件（参见 Bit 文档中的编辑器设置）或 Bit UI 来开始使用了！

创建壳层应用

创建应用壳层以运行、组合并部署你的应用：

bit create react-app corporate-website

运行平台：

bit run corporate-website

访问 http://localhost:3000 查看你的应用壳层。你可以开始设计应用布局和具体页面，逐步构建你的应用。更多关于 构建壳层应用 的信息，请参阅相关文档。

组合组件

创建要组合到功能中的组件。例如，运行以下命令为应用的登录路由创建一个新的 React UI 组件：

bit create react pages/login

有关创建 NodeJS 模块、UI 组件、应用、后端服务等的简单指南，请参阅 创建组件文档。

将组件组合到应用壳层中：

import { Login } from '@my-org/users.pages.login';
import { Routes, Route } from 'react-router-dom';

export function CorporateWebsite() {
  return (
    <AcmeTheme>
      <NavigationProvider>
        <Routes>
          <Route path="/" element={<div>Hello world</div>} />
          <Route path="/login" element={<Login />} />
        </Routes>
      </NavigationProvider>
    </AcmeTheme>
  );
}

访问 http://localhost:3000/login 查看你的新登录页面。 你可以使用 Bit 提供的模板来查看官方模板，或者在我们的 创建组件文档 中找到关于创建 React Hooks、后端服务、NodeJS 模块、UI 组件等方面的指南。此外，还可以使用 Bit Start 启动 Bit UI，以独立预览组件。

发布与部署

你可以选择在 Bit Cloud 上托管作用域，也可以 自行托管作用域。使用以下命令创建你的 Bit Cloud 账户和第一个作用域：

bit login

采用语义化版本控制为你的组件打标签：

bit tag --message "my first release" --major

默认情况下，Bit 使用 Ripple CI 构建组件。你也可以使用 --build 标志在本地机器上构建组件。为了自动化发布流程，可以使用你选择的 CI 工具进行标记和导出，或者直接使用我们提供的 官方 CI 脚本。

完成版本标记后，即可发布你的组件：

bit export

现有项目的现代化改造

前往你的 Bit Cloud 账户，查看组件的构建进度。构建完成后，这些组件就可以通过标准包管理器使用了：

npm install @my-org/users.pages.login

下一步

• 创建更多组件
• 配置你的编辑器
• 配置你选择的 CI
• 从现有项目开始

贡献者

Bit 完全由 Bit 框架构建，您可以在 Bit Cloud 上找到其所有组件。

无论您的贡献大小，我们都深表感谢。在贡献之前，请阅读行为准则。

请参阅贡献指南。

许可证

Apache 2.0 许可证

Bit 快速上手指南

Bit 是一个面向 AI 时代的构建系统，旨在将源代码组织为可组合的组件。它支持从开发到 CI 的全流程，帮助开发者（及 AI 代理）高效创建、复用和部署可靠的应用程序。Bit 原生支持 TypeScript 和 ESM，并兼容 React、Vue、Angular、Next.js 等主流前端框架及 Node.js 后端环境。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS, 或 Linux
• Node.js：建议安装 LTS 版本（Bit 依赖 Node 环境运行）
• 包管理器：npm, yarn, 或 pnpm（任选其一）
• 代码编辑器：推荐 VS Code，并安装 Bit 相关插件以获得最佳体验

注意：目前官方未提供特定的中国镜像源，请使用全局网络环境或自行配置 npm 镜像加速安装依赖。

安装步骤

1. 安装 Bit 命令行工具

使用 npx 运行 Bit 版本管理器 (BVM) 进行安装，这将把 bit 命令添加到您的系统路径中：

npx @teambit/bvm install

2. 初始化项目

在新文件夹或现有项目中初始化 Bit。请将 my-org.my-project 替换为您在 Bit Cloud 上创建的组织和项目名称（需先注册账号）：

bit init --default-scope my-org.my-project

初始化完成后，即可在当前目录使用 Bit 命令、AI 代理或 Bit UI 界面。

基本使用

以下是创建一个简单的 React 应用壳（Shell Application）并组合组件的最小化流程。

1. 创建应用壳

创建一个用于运行和部署的基础应用结构（以 React 为例）：

bit create react-app corporate-website

启动开发服务器预览应用：

bit run corporate-website

访问 http://localhost:3000 即可查看初始应用页面。

2. 创建组件

创建具体的功能组件，例如一个登录页面组件：

bit create react pages/login

3. 组合组件

在应用壳的代码中引入并组合新创建的组件。编辑主入口文件（如 corporate-website.tsx）：

import { Login } from '@my-org/users.pages.login';
import { Routes, Route } from 'react-router-dom';

export function CorporateWebsite() {
  return (
    <AcmeTheme>
      <NavigationProvider>
        <Routes>
          <Route path="/" element={<div>Hello world</div>} />
          <Route path="/login" element={<Login />} />
        </Routes>
      </NavigationProvider>
    </AcmeTheme>
  );
}

刷新浏览器访问 http://localhost:3000/login 即可看到新组件生效。

4. 发布与部署

当组件开发完成后，可以将其版本化并发布到 Bit Cloud 或私有 Scope。

登录账户：

bit login

标记版本（遵循语义化版本控制）：

bit tag --message "my first release" --major

导出组件：

bit export

发布成功后，其他项目可通过标准包管理器安装使用该组件：

npm install @my-org/users.pages.login