原生 window.scrollTo({ top: 0, behavior: 'smooth' }) 即可实现平滑回顶，但必须配合 html { scroll-behavior: smooth; } CSS 才生效；需防重复触发、拦截默认行为，并对 fixed-top 导航栏动态补偿偏移。

原生

window.scrollTo({ top: 0, behavior: 'smooth' })</strong> 就够了，不需要 Bootstrap 的 JS 插件、也不该依赖 jQuery 动画。所谓“Bootstrap 回顶组件”并不存在——它没提供这个功能，强行套用反而容易出错。</p>

<H3>必须设置 <code>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 锚点，再执行滚动——体验极差。

VPS Bootstrap

从零启动全新 VPS，完成 OpenClaw 完整部署，包括备份/恢复及恢复后验证。用于 OpenClaw 部署。

下载

• 推荐用 <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; } 里。