scroll-margin-top 必须加在带 id 的目标元素上，如 section#about；值需严格等于导航栏总高度，含 padding、border 等；父容器 overflow: hidden 或元素脱离文档流会导致失效；Safari 15.4+ 才支持且需 scroll-behavior: smooth。
scroll-margin-top 必须加在目标元素上，不是 body 或 nav
它只对带 id 的锚点目标生效，比如 section#about、h2[id] 或 div#contact。写在 body、nav 或 :target 上基本无效或不稳定。
常见错误现象：点击链接后内容仍被遮挡，DevTools 里检查发现 scroll-margin-top 根本没计算进去。
-
body { scroll-margin-top: 64px; }❌ ——body不是滚动定位的“吸附主体”，浏览器忽略 -
nav { scroll-margin-top: 64px; }❌ —— 导航栏不是被跳转的目标 -
:target { scroll-margin-top: 64px; }⚠️ —— Safari 偶现失效，且无法响应不同页面导航栏高度变化
值必须严格等于导航栏的视觉总高度
scroll-margin-top 的值不是“大概估”，而是要等于导航栏实际占据的垂直空间——包括 height、padding-top、border-top-width，甚至 box-shadow 向上扩散部分。用 DevTools 的 Computed 面板查最准。
- 移动端导航栏折叠后变矮？不能写死
64px，要用媒体查询：@media (max-width: 768px) { #about { scroll-margin-top: 48px; } } - 推荐抽成 CSS 变量统一管理：
:root { --nav-height: 64px; }，再写#faq { scroll-margin-top: var(--nav-height); } - 避免混用单位：导航栏用
rem，scroll-margin-top就别用px，否则缩放时偏差明显
父容器有 overflow: hidden 或浮动未清除时会失效
如果目标元素父容器设了 overflow: hidden，或目标本身是 display: flex/inline 元素，scroll-margin-top 可能被忽略——因为它要求目标是流内块级元素且未脱离文档流。
立即学习“前端免费学习笔记（深入）”；
- 降级方案：用
padding-top+margin-top: -Xpx组合，数值严格相等，且目标不能是inline - 写法示例：
h2[id] { scroll-margin-top: 64px; padding-top: 64px; margin-top: -64px; } - 浮动塌陷会让偏移失效：给锚点父容器加
display: flow-root;（比overflow: hidden更安全，不裁剪position: absolute子元素）
Safari 和 SPA 场景下容易踩的坑
scroll-margin-top 在 Safari 中支持较晚（15.4+），且仅在 scroll-behavior: smooth 容器内生效；若页面禁用平滑滚动，该属性完全不触发。单页应用中，hash 跳转后不会自动滚动，需手动调用 element.scrollIntoView()。
- SPA 中必须显式调用：
document.getElementById('about')?.scrollIntoView({ block: 'start', behavior: 'smooth' }); - 确保目标元素已挂载 DOM，否则
scrollIntoView报错或无反应 - 不要用
transform: translateY()调整目标位置——它创建新包含块，破坏滚动定位逻辑 - 旧版 Safari（
真正起作用的不是“加了多少”，而是“加在哪”和“加给谁”。很多问题不是属性没生效，而是它根本没被浏览器当作滚动目标识别——ID 缺失、父容器截断、单位混用、Safari 版本太低，这些细节比写法本身更关键。
