# Bootstrap

> 分类：`libs/ui/` · 档位：**评估** · 更新时间：2026-11-17

## 1. 基本信息

| 项 | 内容 |
|---|---|
| 当前版本 | 5.3.x |
| License | MIT |
| 维护方 | Bootstrap 核心团队（@twbs） |
| 仓库 / 文档 | https://github.com/twbs/bootstrap · https://getbootstrap.com |
| 最近 release | 见官方 releases |

## 2. 一句话定位

组件化的 CSS + JS 框架：栅格、按钮、表单、导航、模态、下拉等开箱即用，不依赖 jQuery。
它给你一套完整默认外观与交互，适合"快速搭出可用界面"，不适合高度定制的品牌站。

## 3. 体积

| 引入方式 | min | gzip |
|---|---|---|
| CSS 全量 | 约 227–232 KB | 约 27–31 KB（第三方口径，待实测） |
| JS bundle | 约 80 KB | 约 23 KB min（官方口径） |
| Sass 按需（栅格 + 表单 + 工具类） | 明显更小 | 待实测 |

## 4. 核心 API

```html
<link href="bootstrap.min.css" rel="stylesheet">
<script src="bootstrap.bundle.min.js"></script>

<button class="btn btn-primary" data-bs-toggle="modal" data-bs-target="#m">打开</button>
```

```js
const modal = new bootstrap.Modal('#m');
modal.show();
```

## 5. 适用 / 不适用

- **适用**：后台管理、内部工具、活动页、需要快速交付的 CRUD 界面。
- **不适用**：强品牌定制、极致体积要求的营销页（Tailwind 或原生 CSS 更合适）。

## 6. 硬缺口与已知坑

- 默认视觉辨识度高，深度定制需要改 Sass 变量并重新编译。
- 全量 CSS/JS 偏重，不用 Sass 裁剪就会带着大量未用组件。
- 组件依赖特定 DOM 结构与 `data-bs-*` 属性，替换成自定义结构成本高。
- 与 Tailwind 等原子化方案混用容易产生优先级与重置冲突。
- 无构建场景可直接用 CDN 全量文件，但体积最大。

## 7. 受限环境可用性

| 环境 | 结论 | 说明 |
|---|---|---|
| 无构建（CDN） | 可用 | 全量引入，无需编译 |
| ESM / 打包器 | 可用 | 可按模块引入 JS |
| SSR | 可用 | 只输出 CSS/JS，与渲染无关 |
| 客户端重渲染 | 需初始化 | 动态插入的组件需重新 `new` |

## 8. 稳定性评分

| 维度 | 评分 | 依据 |
|---|---|---|
| 维护活跃度 | 4 | 长期维护，节奏平稳 |
| 版本与破坏性变更 | 4 | 5.x 稳定，v6 尚远 |
| 采用度 | 5 | 使用面极广 |
| 体积与按需 | 3 | 全量偏大，需 Sass 裁剪 |
| 生态兼容 | 5 | 无框架绑定 |
| License | 5 | MIT |

## 9. 替代品对比

| 库 | 优势 | 劣势 | 何时选它 |
|---|---|---|---|
| Tailwind CSS | 产物小、设计自由度高 | 需构建，无现成组件 | 品牌化界面 |
| Bulma | 纯 CSS、无 JS 依赖 | 交互组件要自己写 | 只要样式 |
| Pico.css | 约 10 KB、语义化零构建 | 组件与工具类少 | 内容型站点 |
| DaisyUI | 基于 Tailwind 的组件层 | 依赖 Tailwind 构建 | 想要组件又要原子化 |
