Bootstrap 5+ 官方已停更中文文档，应直接访问英文官网 https://getbootstrap.com/docs/5.3/ 并用浏览器翻译，或本地构建官方源码文档；查用法可拼路径直达组件页，注意 API 差异与语义约束。
Bootstrap 官方中文文档在哪找
Bootstrap 5 及之后版本官方已不再维护中文文档，https://getbootstrap.com 只提供英文版。所谓“中文文档”基本是社区翻译或第三方镜像，质量参差不齐，且长期未同步更新——比如 Bootstrap 5.3 的新组件 offcanvas 或 toast 的 API 变更，在多数中文页面里根本没体现。
实操建议：
- 优先打开英文官网
https://getbootstrap.com/docs/5.3/（把 URL 中的5.3换成你实际用的版本号） - 浏览器右键 → “翻译成中文”，Chrome / Edge 的实时翻译对技术文档准确率尚可，尤其类名、属性名、代码块基本不误译
- 慎用百度搜索“Bootstrap 中文文档”，排在前几的多为 2020 年前的旧版（如 Bootstrap 3），
container-fluid和container的响应式行为差异都可能写错
怎么快速查某个 class 或组件的用法
别从首页目录逐级点进去。Bootstrap 文档结构清晰，直接在地址栏拼路径最省时间：
- 查
btn类：访问https://getbootstrap.com/docs/5.3/components/buttons/ - 查
form-control：去https://getbootstrap.com/docs/5.3/forms/form-control/ - 查 JS 方法（如
Modal.show()）：进https://getbootstrap.com/docs/5.3/components/modal/#methods
注意：所有 JS 组件方法和事件名都区分大小写，modal('show') 是 jQuery 时代的写法，Bootstrap 5+ 已废弃，必须用 myModal.show() 实例调用。
为什么按中文文档写代码总报错
常见原因不是语法错，而是版本错位或上下文缺失：
- 中文页写着
<div class="card"> 就完事，但没提必须包裹在 <code><div class="card-body"> 里才能正确继承 padding —— 这属于语义约束，英文文档在每个示例下方有明确 note 提示<li>复制了中文页的 JS 初始化代码，但漏了前提：Bootstrap 5 要求先引入 <code>bootstrap.bundle.min.js（含 Popper），而不是只引bootstrap.min.js - 看到“支持 data-bs-* 属性”，却写成
data-toggle="modal"（Bootstrap 4 写法），实际应为data-bs-toggle="modal"，少bs-前缀就完全不触发 - 克隆官方文档源码：
git clone https://github.com/twbs/bootstrap.git - 进入
site/content/docs/5.3/目录，用 Hugo 启动本地服务（需提前装 Hugo）：hugo server --port 8080 - 浏览器打开
http://localhost:8080，就是和官网完全一致的实时文档，包括所有交互示例和响应式预览
本地离线看文档还靠谱吗
可以，但得自己构建，不能靠下载“中文文档打包版”。那些 ZIP 文件通常是静态爬取的过期快照，连 CSS 都可能加载失败。
推荐做法：
真正容易被忽略的是：文档里的每个代码块都带「Copy」按钮，但复制出来默认不含 <script></script> 引入逻辑；而多数功能（如 dropdown）依赖 JS 初始化，光抄 HTML 不会动。这点英文文档每节开头都加粗提醒了，中文搬运版几乎全删了。
