返回顶部按钮点不动，主要因scrollTo(0,0)作用于window但实际滚动容器是overflow:auto的div或body被overflow:hidden锁定；需确认滚动主体并调用对应元素的scrollTo，或改用window.scrollY+requestAnimationFrame节流监听。
返回顶部按钮为什么点不动？检查 scrollTo 的调用时机和目标
常见问题是按钮绑定了点击事件，但点击后页面没滚动——大概率是用了 scrollTo(0, 0) 却没考虑文档流或滚动容器。原生 scrollTo 默认作用于 window，但如果页面设置了 overflow: hidden 在 html 或 body 上，或者用了自定义滚动容器（比如 div#app），window.scrollTo 就会失效。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 优先用
window.scrollTo({ top: 0, behavior: 'smooth' })，比scrollTop = 0更可靠且支持平滑动画 - 如果整个页面由某个
div负责滚动（如单页应用中main区域设置了overflow-y: auto），要对该元素调用scrollTo，而不是window - 确保目标元素存在且可滚动：在绑定事件前，用
document.querySelector('.scroll-container')?.scrollTo判断是否可用
按钮怎么才不遮挡内容又始终可见？定位和层级的关键参数
用 position: fixed 是最直接的方案，但容易被其他 z-index 更高的组件盖住，或在小屏上挤压内容。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 按钮样式必须包含
position: fixed; bottom: 24px; right: 24px;，避免用top+height计算位置（滚动时可能错位） -
z-index至少设为100，低于弹窗但高于导航栏；若项目用了 CSS-in-JS 或 Shadow DOM，需确认样式作用域是否覆盖到该按钮 - 加
pointer-events: none到父容器（如footer）可防止误触遮挡，但按钮自身必须设回pointer-events: auto
什么时候显示/隐藏？监听 scroll 不能只靠 pageYOffset
很多实现用 window.pageYOffset > 300 控制显隐，但在 Safari 或某些安卓 WebView 中，pageYOffset 可能延迟更新，导致按钮闪动或不响应。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 改用
window.scrollY（更现代、兼容性一致），并配合requestAnimationFrame节流，避免频繁重绘 - 不要只依赖单一阈值：对长图文页，可结合
document.documentElement.scrollHeight - window.innerHeight判断是否接近底部，避免用户刚滚动就显示又立刻隐藏 - 移动端需额外处理：iOS Safari 滚动时
scroll事件触发频率低，建议加{ passive: true }并用touchmove作为补充监听
无障碍与 SEO 怎么兼顾？别只写 <button> 就完事
纯图标按钮没有文字内容，屏幕阅读器无法识别；加 aria-label 后又可能被搜索引擎忽略语义。这不是“加个属性”就能解决的权衡问题。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 必须用
<button type="button" aria-label="返回顶部"><span aria-hidden="true">↑</span></button>结构：视觉上只显示箭头，辅助技术读取文字描述 - 不要把按钮放在
<footer>或<aside>等语义区域里——它属于全局导航行为，应置于<body>直接子级，且在 DOM 顺序中尽量靠前 - 若使用 SVG 图标，确保
<svg>有role="img"和aria-hidden="true"，否则屏幕阅读器可能重复播报
真正麻烦的是滚动容器嵌套和第三方 UI 库的样式污染——比如 Ant Design 的 .ant-layout 或 Vue Router 的 router-view 容器，它们可能拦截原生滚动事件或重置 scrollTop。这种时候得先确认滚动主体，再决定是 patch scrollTo 还是换用 IntersectionObserver 触发显隐逻辑。
