bootstrap carousel 不动的首要原因是未正确加载 bootstrap.bundle.min.js，导致 referenceerror 报错；需确保引入对应版本的 bundle 文件、data-bs-ride 属性正确、唯一 active 的 carousel-item 且为直接子元素、指示器编号连续，并在 dom 就绪后初始化。
Bootstrap Carousel 不动？先看控制台有没有 ReferenceError: bootstrap is not defined
这是最直接的信号：JS 根本没加载成功。轮播图所有交互逻辑都依赖 bootstrap.bundle.min.js，只引 CSS 或只引 bootstrap.min.js（不含 Popper）都会导致初始化失败。
- 打开浏览器开发者工具（F12 → Console），刷新页面，一眼就能看到这个报错
- 确认你引入的是
bootstrap.bundle.min.js，不是bootstrap.min.js—— 后者不带 Popper，Carousel 无法启动 - CDN 地址必须匹配版本，比如 Bootstrap 5.3.3 就用
https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js，混用 5.2 和 5.3 的 JS 可能静默失败
data-bs-ride="carousel" 写了但还是不动？检查是否被其他 JS 干扰或提前执行
data-bs-ride="carousel" 是自动初始化的开关，但它只在 DOM 加载完成、JS 执行后起作用。如果页面里有别的脚本删了它、覆盖了 id、或在 DOMContentLoaded 前就操作了 DOM，就会失效。
- 别在 HTML 里写
data-ride="carousel"（Bootstrap 4 写法），5.x 必须是data-bs-ride - 确保外层容器的
id（如id="myCarousel"）和所有data-bs-target属性值完全一致，包括大小写和符号 - 如果你用了
$(document).ready(...)或DOMContentLoaded手动初始化，记得删掉data-bs-ride，否则可能冲突
结构对但轮播卡死？重点查 .carousel-item 的 active 状态和数量
Carousel 初始化时会找第一个带 active 类的 .carousel-item 作为起点。如果没找到，或多个同时有 active，它就停在那里不动。
- 必须且仅有一个
.carousel-item有active类；多加一个或漏掉都不行 - 每个
.carousel-item必须是.carousel-inner的**直接子元素**，嵌套一层div就会断掉轮播逻辑 - 指示器（
.carousel-indicators）里的data-bs-slide-to值要从0开始连续编号，不能跳号或重复
手动初始化也无效？试试 carousel('cycle') 而不是 carousel()
有时候 data-bs-ride 和 $('#myCarousel').carousel() 都不触发自动播放，但 carousel('cycle') 能强制启动——这是实际项目中验证有效的兜底方案。
- 在页面底部或
DOMContentLoaded回调里加一句：const myCar = new bootstrap.Carousel(document.getElementById('myCarousel')); myCar.cycle(); - 或者用 jQuery 风格（仅限仍用 jQuery 的项目）：
$('#myCarousel').carousel('cycle'); - 注意：如果轮播容器还没渲染进 DOM 就调用，会静默失败；确保脚本在元素存在后再执行
id、data-bs-target、CSS/JS 版本这三处改漏一个，就全盘失效。
