应优先使用 CSS scroll-behavior: smooth 配合锚点实现，即在 html 上设 scroll-behavior: smooth，页面顶部设 id="top" 元素，底部用 href="#top" 链接；若需 JS 控制，则调用 element.scrollIntoView({ behavior: 'smooth' })。

回到顶部按钮要不要用 window.scrollTo？

直接用 window.scrollTo(0, 0) 最简单，但体验差：没有滚动动画、不兼容旧版 Safari（iOS 15.4 之前不支持 behavior: 'smooth'）。更稳妥的做法是结合 CSS scroll-behavior: smooth + 原生锚点，既轻量又符合语义。

如何用纯 HTML/CSS 实现平滑回到顶部？

核心就两步：一个带 id="top" 的目标元素，一个指向它的链接。前提是根容器开启滚动平滑行为。

• 在 或 上加样式：scroll-behavior: smooth
• 页面顶部放一个空锚点：（或复用
  等已有元素的 id）
• 底部按钮写成：回到顶部

html {
  scroll-behavior: smooth;
}

href="#top" 失效的常见原因

锚点跳转失败，90% 是因为目标元素不可滚动或被遮挡。

• id="top" 元素没渲染出来（比如被 v-if 或 ngIf 动态移除）
• 页面高度不足一屏，浏览器认为“已在顶部”，不触发滚动
• position: fixed 或 transform 导致父容器创建了新的层叠上下文或滚动容器，使 #top 不在文档主滚动流中
• CSS 中设置了 overflow: hidden 在 或 上（会禁用锚点滚动）

需要 JS 控制时该调用哪个 API？

当必须用 JS（比如监听滚动自动显示/隐藏按钮），优先用 element.scrollIntoView()，而不是 scrollTo()。

• document.getElementById('top').scrollIntoView({ behavior: 'smooth' }) 更可靠，自动计算目标位置，兼容性也好于 scrollTo 的 behavior 参数
• 避免直接操作 window.pageYOffset + animate()，容易和 CSS 滚动行为冲突
• 如果要兼容 IE，只能降级为 scrollTop = 0 + requestAnimationFrame 手写缓动，但 IE 已无必要支持