bootstrap 5 轮播图（carousel）不自动切换或手动控制失效，通常因缺少必需的 javascript 依赖（如 bootstrap bundle 或 popper）、未正确引入资源、或 html 结构缺失关键属性所致。本文提供一站式排查与修复指南。
要使 Bootstrap 5 的 Carousel 正常滑动（包括自动轮播、左右按钮控制和指示器交互），必须确保以下三项全部满足：
✅ 1. 正确引入 Bootstrap 样式与 JS 资源
Bootstrap 5 不再依赖 jQuery，但强依赖 Popper 和 Bootstrap JS。推荐使用官方 CDN 提供的 bootstrap.bundle.min.js（已内置 Popper），无需单独引入 Popper —— 这是新手最常踩的坑。
✅ 推荐引入方式（精简、可靠）：
⚠️ 错误做法（导致 Carousel 失效）：
- 只引入 bootstrap.min.js（不含 Popper，Carousel 组件无法初始化）；
- 混用 bootstrap.min.js + 单独 Popper（易版本冲突）；
- 忘记引入任何 JS 文件（仅 CSS 无法触发交互逻辑）。
✅ 2. 确保 HTML 结构完整且语义正确
你的代码结构基本正确，但需注意两个关键点：
