应直接使用 window.scrollTo({ top: 0, behavior: 'smooth' })，因其稳定可控且现代浏览器已全面支持；避免 href="#top"（干扰路由）和 scrollIntoView()（兼容性差、对齐异常、静默失败）。
直接用 window.scrollTo({ top: 0, behavior: 'smooth' })，别绕弯写锚点或依赖 scrollIntoView() —— 它更稳、更可控，且现代浏览器（Chrome 61+、Firefox 68+、Safari 15.4+）已全面支持。
为什么不用 href="#top" 或 scrollIntoView()？
锚点跳转（<a href="#top">）会改写 URL、干扰前端路由、无法阻止默认行为导致跳页；scrollIntoView() 在 Safari 15.4 之前和 iOS 微信 WebView 中完全忽略 behavior: 'smooth'，表现为生硬跳转甚至静默失败。更麻烦的是：它默认对齐方式是 block: 'center'，结果目标元素被拉到视口中央，顶部反而留白。
- 必须显式传参：
element.scrollIntoView({ behavior: 'smooth', block: 'start' })，否则行为不可控 - 目标元素若为
display: none或在overflow: hidden容器内，scrollIntoView()会静默失败，控制台无报错 - 单页应用中，组件卸载后若未清理监听，容易触发
Cannot read property 'scrollTo' of null
按钮显示逻辑怎么写才不卡顿？
滚动监听不做节流，低端 Android 设备上频繁重绘会导致明显掉帧。别用 document.body.scrollTop 判断——标准模式下它恒为 0；也别在 scroll 回调里直接操作 style.display。
- 统一用
window.scrollY或document.documentElement.scrollTop获取偏移量 - 阈值设为 300px 左右较合理：太小干扰首屏，太大用户可能已放弃返回
- 用
requestAnimationFrame包一层再更新显隐状态，比setTimeout更精准 - CSS 上优先用
display: none/block，避免在 iOS Safari 上用opacity + transition—— 有渲染 bug
fixed 按钮点了没反应？先查这三件事
按钮被盖住、点击穿透、或滚动目标错位，90% 是定位和层叠问题，不是 JS 写错了。
立即学习“前端免费学习笔记（深入）”；
- 确保按钮有
position: fixed且z-index: 999以上，同时确认父容器没用transform或filter触发新层叠上下文 - 检查是否被
header、轮播图或弹窗遮挡 —— 真机测试时尤其注意 iOS Safari 的点击穿透现象 - 如果页面用了局部滚动容器（如侧边栏
overflow-y: auto），window.scrollTo不起作用，得换成该容器的element.scrollTo({ top: 0 })
固定头部遮挡内容？CSS 比 JS 更可靠
点击返回顶部后，目标元素被 position: fixed 导航栏挡住，本质是布局补偿缺失，不是滚动没到位。
- 给目标锚点元素（如
<div id="top"></div>）加scroll-margin-top: 60px（值等于头部高度），浏览器原生滚动会自动预留空间 - 单位必须是
px或rem，%不生效；Firefox 旧版本需手动开启layout.css.scroll-margin.enabled（现代版已默认开） - 别用
margin-top: -60px; padding-top: 60px模拟 —— 会破坏文档流，影响 SEO 和屏幕阅读器 - 头部高度动态变化时（如响应式折叠），用 JS 动态设置 CSS 变量并监听
resize事件更新，比反复计算getBoundingClientRect().top更轻量
真正难调的不是滚动代码本身，而是不同浏览器对 scroll-behavior 的实现差异、iOS 上 fixed 元素的点击失灵、以及局部滚动容器的识别盲区 —— 这些都得靠真机反复验证，桌面 Chrome 调不出全部问题。
