推荐使用 window.scrollTo({ top: 0, behavior: 'smooth' }) 实现平滑回到顶部，前提是必须设置 html { scroll-behavior: smooth; }，并注意 fixed 导航栏偏移和事件中调用 preventDefault()。
用 scrollTo + { behavior: 'smooth' } 最直接有效
原生 js 就能搞定，不需要 bootstrap 自带的 js 插件或额外依赖。bootstrap 5 的 scrollspy 或 navbar 本身不提供滚动逻辑，它只监听、不控制滚动行为。
常见错误是试图用 $('html, body').animate()（jQuery）或手动 scrollTop 赋值——前者在现代浏览器里多余且可能冲突，后者完全无动画效果。
- 必须同时设置
html和body的scroll-behavior: smoothCSS，否则 JS 的behavior: 'smooth'会被忽略 -
window.scrollTo({ top: 0, behavior: 'smooth' })是唯一推荐调用方式；element.scrollIntoView({ behavior: 'smooth' })仅适用于跳转到某元素，不是“回到顶部” - 如果页面有固定头部（比如 Bootstrap 的
fixed-topnavbar），记得在scrollTo后加offsetTop补偿，否则会遮挡内容
CSS 中漏掉 scroll-behavior: smooth 就没动画
这是最容易被跳过的一步。哪怕 JS 写对了，只要根级滚动容器没开启平滑行为，behavior: 'smooth' 会静默退化为瞬间跳转。
只需一行 CSS：
html { scroll-behavior: smooth; }
注意：body 上设无效，必须是 html 元素；部分旧版 Safari 需要加 -webkit- 前缀，但 iOS 15.4+ 和主流 Chrome/Firefox 已原生支持。
- 不要写成
body { scroll-behavior: smooth; }—— 它不起作用 - 不要试图用
transition: scrollTop 0.3s模拟，CSS 不支持scrollTop的 transition - 如果用了第三方库（如
smooth-scroll），反而可能和 Bootstrap 的锚点跳转逻辑冲突，优先砍掉
绑定按钮时别忘了 preventDefault
很多人在 @#@#@#@#@#@#@#@#@#@0 上直接加 onclick="window.scrollTo(...)"，结果点击后页面先跳到 #top 锚点（闪一下），再执行滚动——这是默认跳转没拦住。
- 必须在事件回调里调用
event.preventDefault() - 推荐用
data-bs-toggle="scroll"这类自定义属性，而不是滥用data-bs-toggle="collapse"或其它 Bootstrap 语义 - 如果按钮在
fixed-bottom里，注意移动端键盘弹出时视口变化可能导致目标位置偏移，可加setTimeout延迟 100ms 再滚动
兼容性差的场景下 fallback 很简单
IE 和部分老 Android WebView 不支持 behavior: 'smooth'，但没必要引入整个 polyfill 库。检测失败就降级为同步滚动即可，用户感知差异极小。
判断方式很轻量：
if ('scrollBehavior' in document.documentElement.style) {<br> window.scrollTo({ top: 0, behavior: 'smooth' });<br>} else {<br> window.scrollTo(0, 0);<br>}
- 不用查 UA，
scrollBehavior支持度可直接特征检测 - 不要用
try/catch包裹scrollTo—— 它永远不会抛错，只是静默忽略behavior - 如果项目已用 Bootstrap 5 的
Offcanvas或Modal，确保它们的 backdrop click 不意外触发页面滚动
getBoundingClientRect() 动态算，不能写死 offset。
