bootstrap导航条滚动监听失效主因是data-bs-spy与data-bs-target未同时正确设置于滚动容器，或目标区域无高度；需确保二者成对出现、目标元素有min-height、offset精准匹配固定头部高度，并在spa中手动dispose重建实例。
Bootstrap 导航条滚动监听（Scrollspy）失效，**90% 是因为 data-bs-spy 和 data-bs-target 没同时加对位置，或目标区域没高度**。它不会报错，只是静默不工作——你拖动页面，导航项始终不加 .active 类，就是这个原因。
data-bs-spy 和 data-bs-target 必须成对出现在正确元素上
Scrollspy 不是全局插件，它只监听“被标记为滚动容器”的那个元素的滚动行为。漏掉任一属性，或加在错误位置，整个功能就归零。
-
data-bs-spy="scroll"必须加在**实际发生滚动的容器**上：通常是；如果你用了自定义滚动区（比如一个<div class="scrollable"> 且设置了 <code>overflow-y: auto），那就得加在这个div上，而不是body -
data-bs-target必须指向**导航父容器的 ID 或 class**，且必须能直接选中该容器：写#navbar就要求存在<nav id="navbar"></nav>；写.navbar就要求外层有class="navbar"—— 不能写成.navbar a或#navbar .nav-link - 导航内部结构必须是
.nav > li > a（或含.nav-link）；每个<a></a>的href值（如#about）必须严格匹配页面中对应区块的id（如<section id="about"></section>） - 给每个目标
section设最小高度：min-height: 100vh或height: 800px（根据内容调整） - 避免用
display: none或visibility: hidden隐藏目标区块——Scrollspy会跳过不可见元素 - SPA 中（如 Vue/React），确保所有带
id的区块在 JS 初始化Scrollspy前已挂载到 DOM；否则new bootstrap.ScrollSpy(...)会找不到节点，报Cannot read property 'top' of null - 用
getComputedStyle(document.querySelector('.navbar')).height查出导航栏真实高度（比如"72px"），然后设data-bs-offset="72" - 如果页面有多个 sticky 元素叠加（如 header + toolbar），offset 要手动累加，不能只看最上面那个
-
data-bs-offset影响的是 Scrollspy 的激活时机，不是滚动行为本身；要实现平滑且对齐的滚动，还得额外加 CSS：html { scroll-behavior: smooth; } - iOS Safari（15+）默认开启
overflow-anchor: auto，会干扰位置计算，导致高亮滞后或跳变；需强制禁用：body { overflow-anchor: none; } - 每次进入新路由前，先调用旧实例的
.dispose()方法 - 新页面内容挂载完成后，再用
new bootstrap.ScrollSpy(...)重建，确保target和目标id都已就位 - 不要对同一滚动容器重复初始化：
new bootstrap.ScrollSpy(el, opts)不会自动销毁旧实例，必须手动管理生命周期
目标 section 没高度 = Scrollspy 看不见它
Scrollspy 判断“是否进入视口”，本质是计算目标元素顶部距离滚动容器顶部的距离。如果 <section id="about"></section> 高度为 0（比如只靠内联文本撑开，但内容太少），它永远无法触发 .active。
固定导航栏必须配 data-bs-offset，且值要准
没设 data-bs-offset，或者设错值，是导致高亮“偏移”或“卡住”的最常见原因。它不是可选项，而是补偿固定头部遮挡的必要参数。
SPA 路由切换后必须 dispose 再重建
单页应用里，路由跳转后如果只是重新渲染内容，但没清理旧的 Scrollspy 实例，会导致监听残留、状态错乱、甚至内存泄漏。
真正麻烦的点不在配置本身，而在于它不报错、不提示、不 fallback——失效时就像什么都没发生。最稳妥的做法是：先确认滚动容器有高度+溢出，再核对三个 ID 是否完全一致（href、section id、data-bs-target 指向的导航容器 ID），最后用 getBoundingClientRect() 手动测一个目标元素的 top 值，和 offset 对齐逻辑比对一遍。
