scrollintoview({ behavior: 'smooth' }) 是最轻量的原生平滑滚动方案，需配合 html { scroll-behavior: smooth } 使用，适用于现代浏览器，不支持 ie 及旧版 safari，需手动处理 fixed 导航栏偏移和“减少运动”系统设置。
scrollIntoView({ behavior: 'smooth' }) 是最轻量的实现方式
直接调用目标元素的 scrollIntoView 并传入 { behavior: 'smooth' }，就能触发原生平滑滚动，不需要 Bootstrap JS、jQuery 或任何 polyfill。这是现代浏览器（Chrome 61+、Firefox 68+、Edge 79+、Safari 15.4+）原生支持的方案。
常见错误是只写 element.scrollIntoView()，没传参数——它默认是 'auto' 行为，结果还是“瞬移”。必须显式传参，且不能写成 scrollIntoView(true) 或 scrollIntoView('smooth')，这些写法已过时或无效。
使用场景包括导航菜单点击跳转、返回顶部按钮、目录锚点等。若目标是页面顶部，改用 window.scrollTo({ top: 0, behavior: 'smooth' }) 更准确，scrollIntoView 不适合“回到顶部”这种无目标元素的场景。
- 记得在点击事件里调用
event.preventDefault()，否则会先触发默认锚点跳转（URL 变 hash、页面闪动），再执行 JS 滚动 - 如果页面有
fixed-top导航栏，需手动补偿偏移：例如target.offsetTop - 80，否则内容会被遮挡 - 旧版 Safari（如 iOS 15.2）不支持
behavior: 'smooth'，会静默退化为瞬移；无需 polyfill，用户感知差异小
html { scroll-behavior: smooth } 必须配合 JS 使用
scroll-behavior: smooth 是 CSS 级别开关，只对 <a href="#section"></a> 这类原生锚点跳转生效，且无法控制偏移量、回调或动态目标。单独加这行 CSS 不足以支撑完整滚动逻辑。
关键点在于：它必须写在 html 元素上，写在 body 上无效；而且 JS 中的 behavior: 'smooth' 依赖这个 CSS 设置——如果没开，window.scrollTo 或 scrollIntoView 的 smooth 行为会被忽略。
- 必须同时满足两个条件：CSS 开启 + JS 显式传参，缺一不可
- 移动端 Safari 15.4+ 才真正支持该 CSS 属性，更早版本即使写了也无效果
- 无法与固定导航栏做 offset 补偿，所以纯 CSS 方案只适合简单页面
Bootstrap 5 的 ScrollSpy 和 data-bs-* 属性不控制滚动行为
data-bs-spy="scroll" 只监听滚动位置并高亮导航项，它完全不触发、也不干预滚动动作。很多人误以为加了这个属性后点击菜单就会平滑滚动，结果发现还是生硬跳转——这不是配置错了，是功能本来就不包含滚动控制。
同理，data-bs-offset 是用来调整 ScrollSpy 的触发阈值（比如避开 fixed 导航栏高度），不是给滚动动画加偏移的参数。Bootstrap 官方文档明确说明：ScrollSpy 不提供 click-to-scroll 功能。
- 不要在链接上滥用
data-bs-toggle="scroll"这类非标准属性，Bootstrap 没定义它 - 正确做法是保留原生
<a href="#section"></a>，再用 JS 拦截点击并调用scrollIntoView - 如果用了 jQuery 的
$('html, body').animate()，在 Bootstrap 5 中容易和 ScrollSpy 冲突，且移动端可能卡顿
平滑滚动的动效优缺点很实际
优点非常具体：减少视觉跳跃、提升单页导航体验、零依赖、代码极简（几行 JS + 一行 CSS）。对后台系统、文档页、营销页这类以内容为导向的页面，效果立竿见影。
缺点也集中在现实约束上：无法兼容 IE 和老 Android WebView；固定头部偏移需手动计算；ScrollSpy 高亮和滚动动作要分别处理，逻辑稍分离；如果页面结构动态渲染（如 Vue/React 异步组件），得确保目标元素已挂载再调用 scrollIntoView，否则会滚空。
最容易被忽略的是：所有平滑滚动都依赖用户设备开启“减少运动”偏好。macOS/iOS 开启“减少动态效果”后，behavior: 'smooth' 会被系统强制降级为同步滚动——这不是 bug，是尊重用户设置，但测试时容易漏掉这点。
