Bootstrap 5 Tooltip定位偏移根因是脱离滚动/定位上下文，须设container为可滚动祖先（非body），禁用autoplacement，用placement类+margin微调，避免transform干扰。
Bootstrap 5 工具提示（Tooltip）定位偏移，**不是 CSS 写错了，而是它默认脱离了触发元素的滚动/定位上下文**。改 top、left 或加 !important 都会立刻被 Popper.js 覆盖，纯属白忙。
container 必须设为可滚动祖先，不能是 'body'
默认 container: 'body' 是偏移主因：Tooltip 被插到 <body> 下，完全感知不到触发按钮所在滚动容器的 scrollTop。滚动后，它还按初始位置算 top 值，必然错位。
- 找到触发元素最近的、带
overflow-y: auto或scroll的祖先（比如<div class="list-container">） - 初始化时明确指定：
container: '.list-container' - 该祖先不能有
overflow: hidden，否则 Tooltip 会被裁掉 - 若无固定 class，可用函数动态找：
container: function() { return $(this).closest('[data-scrollable]'); }
禁用 autoplacement 防止视觉跳变
默认开启的 autoplacement 会在空间不足时从 top 自动切到 bottom，看起来像“偏移”，其实是方向切换。这不是 bug，但常被误判。
- 明确指定方向并关闭自动切换：
placement: 'top', fallbackPlacement: false - 若需备选，限定范围：
fallbackPlacement: ['top', 'right']（注意：只有boundary: 'window'时才生效） -
boundary: 'window'强制限制在视口内，避免 Tooltip 跑到屏幕外
模态框（Modal）里 Tooltip 错位要换 container
Modal 自带 overflow: hidden 和独立 stacking context，container: 'body' 会让 Tooltip 被遮挡或坐标计算失真。
立即学习“前端免费学习笔记（深入）”；
- 强制挂载到 Modal 内部干净区域：
container: '.modal-body'或container: '.modal-content' - 确保该容器没有
transform或position: relative干扰（查 computed styles） - 别用
data-bs-container="body"+data-bs-placement="auto"组合——auto在 Modal 中基本不可靠
别碰 top/left，微调只用 margin + placement 类
Popper 每次重定位都会重写 style="top: Xpx; left: Ypx;"，硬写 CSS 会被刷掉。唯一安全的像素级调整方式，是利用 Bootstrap 的 placement 钩子类配合 margin。
- 例如指定
placement: 'top'后，加 CSS：.tooltip.top .tooltip-inner { margin-bottom: 4px; } - 或调整整个 tooltip 元素：
.tooltip.top { margin-bottom: 8px; } - 箭头对齐偏差？改
.tooltip.top .tooltip-arrow { bottom: -5px; }（注意单位用 px，rem 会缩放） - 所有这类修改必须加在
.tooltip.{placement}类下，否则不生效
最易被忽略的是：很多“偏移”其实源于祖先节点悄悄加了 transform（比如动画库、图标旋转类），它会直接污染 Popper 的坐标系。打开 DevTools 查 computed transform，确认触发元素及其所有父级返回 none，才是安全起点。
