锚点跳转失效主因是id匹配不严格、非唯一或目标未挂载；fixed导航遮挡用scroll-margin-top解决；SPA中需框架适配或手动scrollIntoView；平滑滚动优先用html{scroll-behavior:smooth}。
锚点跳转失效：90% 是 id 匹配不严格
点击导航链接，URL 变成 #faq 但页面不动——不是 JS 没跑，而是浏览器根本没找到目标。必须同时满足三件事：href="#faq" 中的字符串，和目标元素的 id="faq" 值**完全一致**（大小写、连字符、无空格）；该 id 在整个页面中**唯一**；目标元素是真实 DOM 节点，不能是 display: none 或刚被 JS 删除的残留节点。
常见误判点：class="faq" ≠ id="faq"；id="FAQ" ≠ href="#faq"；动态渲染内容（如 React 组件）里，点击时 id="faq" 还没挂载到 DOM，document.querySelector('#faq') 返回 null，静默失败。
fixed 导航栏遮挡标题：用 scroll-margin-top，别碰 padding-top
点击 #section2 后，<h2 id="section2"></h2> 的顶部被固定在顶部的导航栏盖住——这是浏览器原生行为，不是 bug。它滚动的目标是元素的“逻辑顶部”，不自动补偿 position: fixed 高度。
正确解法只有一行 CSS：h2[id] { scroll-margin-top: 60px; }（把 60px 换成你导航栏实际高度）。这个属性在 Chrome 61+、Firefox 68+、Safari 15.4+ 原生支持，SSR 友好，无 JS 依赖。
立即学习“前端免费学习笔记（深入）”；
千万别用 padding-top: 60px 或 margin-top: -60px 去“撑开”标题——会破坏文档流，响应式下布局错位，打印样式异常，且无法被 scrollIntoView() 正确识别边界。
单页应用（SPA）里 href="#xxx" 失效：路由拦截是设计，不是 bug
Vue Router、React Router v6+、Framework7 等默认劫持所有 a 标签点击，把 #faq 当作路由路径处理，原生锚点滚动被屏蔽。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
按框架分情况处理：
-
Vue Router：在
router/index.js中配置scrollBehavior(to) { if (to.hash) return { selector: to.hash } } -
React Router v6+：必须使用
createHashRouter，并在组件内用useEffect(() => { const el = document.querySelector(location.hash); el?.scrollIntoView({ behavior: 'smooth' }); }, [location.hash]) -
Framework7：禁用原生锚点，手动调用
document.querySelector('#faq')?.scrollIntoView()，但必须确保作用于.page-content容器（而非body）
通用兜底：删掉 href，改用 onclick="document.querySelector('#faq')?.scrollIntoView({ behavior: 'smooth' })"，但 SSR 首屏需额外判断 location.hash 并手动触发一次。
平滑滚动与兼容性：优先用 CSS，JS 仅作 fallback
想让跳转有滚动动画，最简方案是加一行全局 CSS：html { scroll-behavior: smooth; }。它对原生锚点和 scrollIntoView() 都生效，无需 JS，SEO 友好，且能被浏览器前进/后退自然记录。
注意：scroll-behavior 只在 html 元素上有效，写在 div 或 body 上无效；iOS Safari 15.4+ 才支持，旧版需 JS fallback。
若用 JS 主动滚动，别乱设参数：block: 'start'（默认）才等效原生行为；behavior: 'smooth' 要先检测支持：if ('scrollBehavior' in document.documentElement.style)；切勿在 scrollIntoView() 外再调用 window.scrollTo()，两者叠加会冲突。
最常被忽略的是：目标元素若带 transform 或父容器有 overflow: hidden，scrollIntoView() 计算的位置会偏移，此时得用 getBoundingClientRect() 手动修正滚动距离。
