scrollIntoView({ behavior: 'smooth' })可实现平滑滚动，但需注意兼容性：Chrome 61+、Firefox 68+、Edge 79+原生支持，Safari 15.4+才支持，旧版Safari会退化为瞬移；禁用scrollIntoView(true)等过时写法，保底需检测scrollBehavior；Bootstrap 5的scrollspy仅监听滚动不触发跳转，锚点跳转需手动拦截链接并调用scrollIntoView；jQuery animate易与scrollspy冲突且忽略固定头部，移动端还可能卡顿；锚点失效主因是ID非法、元素未渲染或hashchange被拦截。
scrollIntoView 用对了就能平滑滚动，但默认不平滑
原生 scrollintoview 是最轻量、兼容性最好的方案，但它默认是“瞬移”——没有过渡动画。想平滑，必须显式传参，而且不是所有浏览器都认同一个写法。
- 现代写法：
element.scrollIntoView({ behavior: 'smooth' })，Chrome 61+、Firefox 68+、Edge 79+ 支持 - Safari 15.4+ 才开始支持
{ behavior: 'smooth' }，旧版 Safari（包括 iOS 15.2）会直接忽略该参数，退化为瞬移 - 别写
scrollIntoView(true)或scrollIntoView('smooth')—— 这些是过时或无效写法，部分环境会报错或静默失败 - 如果要保底兼容老 Safari，得加一层检测：
if ('scrollBehavior' in document.documentElement.style) { ... }再决定是否启用 smooth
Bootstrap 5 自带 scrollspy 不等于自动滚动，它只监听不触发
scrollspy 是 Bootstrap 的“滚动监听”组件，常被误认为能处理锚点跳转。其实它只干一件事：当用户滚动时，自动更新导航栏高亮项。点击导航跳转到锚点？得自己写逻辑。
- Bootstrap 5 官方文档里明确说：
scrollspy不提供click-to-scroll功能 - 常见错误：给
<a href="#section1">加了data-bs-toggle="scrollspy"—— 这个属性根本不存在，会被忽略 - 正确做法是保留原生链接，再用 JS 拦截点击：
document.querySelectorAll('[href^="#"]').forEach(...)，然后调用scrollIntoView - 注意避开
<a href="#">这种空锚点，否则会滚到页面顶部且 URL 变成#，影响浏览器历史记录
jQuery animate + offset 在 Bootstrap 项目里容易和 scrollspy 冲突
很多老项目还在用 $('html, body').animate({ scrollTop: $target.offset().top }, 300)。这在纯 jQuery 项目里没问题，但在 Bootstrap 5 中可能出问题。
- Bootstrap 5 已弃用 jQuery，如果你没引入 jQuery，这段代码直接报
$ is not defined - 即使引入了，
scrollspy依赖原生滚动事件，而animate是靠定时器模拟滚动，会导致scrollspy高亮延迟或错位 -
$target.offset().top没考虑固定头部（如 navbar），结果目标元素被遮挡 —— 必须手动减去navbar.offsetHeight - 更麻烦的是：移动端 touch 滚动下，
animate的定时器可能被系统节流，导致卡顿或跳变
锚点失效的三个高频原因：ID 重复、未渲染、hashchange 被拦截
点了链接没滚动？八成不是 scrollIntoView 写错了，而是锚点本身没生效。
-
id值含空格、中文或特殊字符（如id="section 1"）—— 浏览器无法匹配，必须用合法标识符（字母开头，只含字母数字和下划线） - 目标元素是异步加载的（比如 Vue/React 组件、AJAX 插入内容），点击时 DOM 还没挂载 —— 要等元素存在再执行滚动，可用
MutationObserver或setTimeout重试 - 某些 SPA 框架（如 Vue Router）或插件会监听
hashchange并阻止默认行为，导致href="#xxx"点击后 URL 变了但页面不动 —— 查看控制台是否有event.preventDefault()调用痕迹
平滑滚动真正难的不是写法，而是判断什么时候该用原生、什么时候得降级，以及怎么让锚点在动态渲染和多框架共存的页面里始终可靠。ID 写错、元素没出来、路由劫持——这些比“怎么加动画”更容易卡住人。
