Bootstrap

Bootstrap 简介

Bootstrap 是 Twitter 开源并持续维护的前端框架，提供一整套 HTML、CSS 与 JavaScript 组件，帮助开发者快速搭建响应式、移动优先的 Web 项目。它长期位居 GitHub 最受欢迎项目之列，被大量企业官网、后台系统与开源项目采用。

注意：仓库默认分支用于开发 Bootstrap 6；如需 Bootstrap 5 的源码与文档，请切换到 v5-dev 分支。

核心能力

• 栅格系统：基于 flex 的 12 列布局，支持多断点响应式排列。
• 组件库：按钮、表单、导航栏、模态框、下拉菜单、提示框、轮播等常用 UI 组件。
• 工具类：间距、颜色、排版、显示与弹性布局等原子类，减少手写 CSS。
• Sass 定制：通过变量与 map 覆盖主题色、圆角、断点等设计令牌。
• RTL 支持：CSS 基于逻辑属性编写，在 HTML 上设置 dir="rtl" 即可切换从右到左布局。

安装与引入

Bootstrap 支持多种引入方式，可按项目技术栈选择：

# npm
npm install bootstrap

# yarn
yarn add bootstrap

# Bun
bun add bootstrap

# Composer（PHP 项目）
composer require twbs/bootstrap

也可以直接下载发行包，或通过 CDN 引入编译后的 CSS/JS 文件。

发行包结构

下载的压缩包按资源类型组织，同时提供编译版与压缩版：

bootstrap/
├── css/
│   ├── bootstrap.css
│   ├── bootstrap.min.css
│   ├── bootstrap-grid.css
│   ├── bootstrap-reboot.css
│   └── bootstrap-utilities.css
└── js/
    ├── bootstrap.js
    ├── bootstrap.min.js
    ├── bootstrap.bundle.js
    └── bootstrap.bundle.min.js

其中 bootstrap.bundle.* 已内置 Floating UI 与 Vanilla Calendar Pro 等依赖，适合不借助打包工具直接引入的场景；*.map 文件用于浏览器开发者工具调试。

本地文档

官方文档位于仓库根目录，使用 Astro 构建，搜索由 Pagefind 提供支持。本地运行大致流程为：

1. 执行 npm install 安装依赖；
2. 运行构建脚本重新生成 CSS/JS 与文档资源；
3. 执行 npm run docs-serve 启动本地文档服务；
4. 在浏览器访问本地端口查看文档。

适用建议

Bootstrap 适合追求交付速度、需要稳定组件基础的项目。若项目对视觉独特性要求极高，建议在 Bootstrap 之上做主题层定制，或评估其他更轻量的方案。参与贡献前请先阅读仓库的贡献指南与编码规范。