data-bs-spy="scroll" 必须加在实际滚动的容器上（如自定义 div 而非 body），data-bs-target 需指向含 .nav 或 .list-group 的父容器，目标区域须有唯一 id 且 DOM 顺序一致，并通过 data-bs-offset 补偿固定导航栏高度。
data-bs-spy="scroll" 必须加在滚动容器上，不是 body 就是自定义容器
scrollspy 不监听整个页面的滚动事件，而是监听你指定的**滚动容器**。默认情况下，bootstrap 5 要求把 data-bs-spy="scroll" 放在 body 上——但前提是 body 自己能滚动（即没有 overflow: hidden，且内容超出视口）。现实中很多项目用了 height: 100vh; overflow-y: auto 的主容器，这时必须把 data-bs-spy 移到那个容器上，否则监听完全失效。
- 常见错误现象：
.active类死活不加，导航项始终无高亮 - 检查方法：用浏览器开发者工具看滚动事件是否触发，再确认
getBoundingClientRect()计算出的目标元素是否在视口内 - 正确写法示例：
<div data-bs-spy="scroll" data-bs-target="#navbar"></div>
- 如果容器有固定高度或 padding，记得配
data-bs-offset补偿（比如data-bs-offset="80"抵消顶部导航栏高度）
data-bs-target 必须指向含 .nav 或 .list-group 的父容器
Scrollspy 不认任意导航结构，它只扫描 data-bs-target 指定元素内部的 .nav > .nav-link 或 .list-group > .list-group-item，并匹配其 href 值（如 #section1）与目标区域的 id。
- 容易踩的坑：用
div#navbar包着一堆a标签，但没加.nav类；或者 href 写成/#section1（带斜杠）导致无法匹配id="section1" - 使用场景：侧边栏目录、顶部胶囊导航、文档页锚点列表都适用，只要结构合规
- 参数差异：
data-bs-target接受 CSS 选择器，支持#id、.class，但不能是nav[data-id="main"]这类复杂属性选择器（Bootstrap 内部用querySelector查找）
目标区域必须有 id，且顺序和 DOM 流一致
Scrollspy 判断“当前可见区域”时，是按 DOM 中出现的先后顺序，取**第一个顶部进入视口的锚点元素**，然后高亮对应导航项。这意味着：
- 所有目标区块（如
<section id="intro"></section>）必须有唯一id，且不能重复或缺失 - 如果某区块高度不足 1px（比如空
div+ margin 撑开），可能被跳过；建议最小高度设为min-height: 100vh或明确值 - 性能影响：目标区域越多，每次滚动都要遍历计算
getBoundingClientRect()，百个以上锚点时可考虑节流或改用 IntersectionObserver 手动实现 - 兼容性注意：IE 不支持
IntersectionObserver，但 Scrollspy 本身用的是传统滚动监听，所以 IE11 仍可用（需引入 Popper 和 Bootstrap JS）
偏移量 data-bs-offset 是最常被忽略的调试入口
默认偏移是 0，意味着目标元素**顶部一碰到视口顶部**就触发高亮。但实际中，顶部常有固定导航栏（比如 60px 高），这时用户看到的“可视区域起始点”其实是视口 y=60px 处，不调偏移就会提前高亮。
- 调试技巧：打开控制台，在滚动时执行
document.querySelector('#section2').getBoundingClientRect().top，观察它何时接近 0；再对比你设置的 offset 值 - 推荐做法：把 offset 设为固定导航栏高度（如
data-bs-offset="60"），或用 JS 动态读取getComputedStyle(document.querySelector('.navbar')).height - 注意：offset 只影响“激活时机”，不影响滚动行为本身；平滑滚动需额外加
CSS scroll-behavior: smooth或 JSscrollIntoView({ behavior: 'smooth' })
真正卡住人的往往不是配置写错，而是滚动容器判断错了、offset 没对齐视觉基准线、或者目标 id 和 href 字符串不完全一致——这三个地方多打两次 console.log，比重写逻辑快得多。
