原生 window.scrollto({ top: 0, behavior: 'smooth' }) 即可实现平滑回顶，但必须配合 html { scroll-behavior: smooth; } css 才生效；需防重复触发、拦截默认行为，并对 fixed-top 导航栏动态补偿偏移。
原生 window.scrollTo({ top: 0, behavior: 'smooth' }) 就够了，不需要 Bootstrap 的 JS 插件、也不该依赖 jQuery 动画。所谓“Bootstrap 回顶组件”并不存在——它没提供这个功能，强行套用反而容易出错。
必须设置 html { scroll-behavior: smooth; }
这是最常被跳过的一步。哪怕 JS 调用写得完全正确，只要 CSS 没开，behavior: 'smooth' 就会静默退化为瞬间跳转。
-
body { scroll-behavior: smooth; }无效，必须作用在html元素上 - 旧版 Safari（iOS 15.3 及更早）需要加
-webkit-scroll-behavior: smooth;前缀，但主流 Chrome/Firefox/Edge 和 iOS 15.4+ 已原生支持 - 如果用了第三方平滑滚动库（如
smooth-scroll），可能和 Bootstrap 的锚点跳转逻辑冲突，优先移除
点击按钮时别忘了 event.preventDefault()
直接给按钮写 href="#top" 或绑定 onclick="window.scrollTo(...)”，不拦默认行为，页面会先闪一下跳到 #top 锚点，再执行滚动——体验极差。
- 推荐用
<button type="button" id="back-to-top">回到顶部</button>，避免 href 引发默认跳转 - 事件监听里必须调用
event.preventDefault()，哪怕只是空链接也要拦 - 如果按钮放在
fixed-bottom里，移动端键盘弹出时视口变化可能导致目标位置偏移，可加setTimeout(() => { ... }, 100)延迟执行
有固定导航栏时要手动补偿偏移
Bootstrap 的 fixed-top 导航栏会遮挡顶部内容，单纯滚到 top: 0 会导致首屏内容被盖住。
- 补偿方式不是改 CSS 的
margin-top，而是在 JS 中减去导航高度：window.scrollTo({ top: -80, behavior: 'smooth' })（假设导航高 80px） - 更健壮的做法是动态读取：
const navbar = document.querySelector('.fixed-top'); const offset = navbar ? navbar.offsetHeight : 0; window.scrollTo({ top: -offset, behavior: 'smooth' }); - 别试图用
transition: scrollTop 0.3s模拟——CSS 不支持对scrollTop做过渡
真正难的不是写代码，而是意识到：Bootstrap 本身不控制滚动行为，所有“平滑”都得自己补；而最容易失效的环节，往往藏在那一行不起眼的 html { scroll-behavior: smooth; } 里。
