bootstrap tooltip 不显示，90% 是未手动初始化实例；bootstrap 5.3+ 移除 data-bs-toggle="tooltip" 自动激活，必须显式调用 new bootstrap.tooltip(el)，且需确保 dom 就绪、js 已加载、动态元素单独初始化。
Bootstrap Tooltip 不显示，90% 是没手动初始化实例，不是 HTML 写错、也不是 CSS 被覆盖——Bootstrap 5.3+ 彻底移除了 data-bs-toggle="tooltip" 的自动激活能力，必须显式调用 new bootstrap.Tooltip(el)。
为什么加了 data-bs-toggle="tooltip" 还是没反应
因为 Bootstrap 5+ 不再监听 DOM 属性变化。哪怕元素上明明白白写着 data-bs-toggle="tooltip" 和 title="提示"，只要没执行 JS 初始化，它就只是个普通带属性的元素，不会绑定任何事件或渲染 tooltip。
- 常见错误：脚本放在
里，或在bootstrap.bundle.min.js加载前执行 - 另一个坑：把初始化代码写在
底部，但 DOM 尚未解析完，querySelectorAll返回空列表 - 正确时机：用
DOMContentLoaded事件包裹，确保 DOM 就绪且 JS 已加载
初始化脚本放哪儿才安全
必须确保 bootstrap.bundle.min.js（含 Popper）已加载完成，再执行初始化逻辑。推荐写法：
document.addEventListener('DOMContentLoaded', () => {
const tooltipTriggerList = [].slice.call(
document.querySelectorAll('[data-bs-toggle="tooltip"]')
);
tooltipTriggerList.map(el => new bootstrap.Tooltip(el));
});
- 别用
$('[data-bs-toggle="tooltip"]').tooltip()（jQuery 写法），Bootstrap 5 已弃用 jQuery 依赖 - 如果只初始化单个元素，直接写
new bootstrap.Tooltip(document.getElementById('myBtn'))更可控 - 动态插入的元素（如 AJAX 渲染、Vue/React 组件内）必须单独调用
new bootstrap.Tooltip(el)，不能指望一次初始化覆盖所有未来节点
Tooltip 显示错位、被裁剪、点开后消失
错位和“不显示”常是同一问题的两种表现：父容器设置了 overflow: hidden、overflow: auto 或 transform，导致 tooltip 元素被裁剪或定位偏移。
- 检查开发者工具中 tooltip 元素（
div.tooltip）的 computedoverflow，向上逐级排查哪个祖先触发了裁剪 - 最常用解法：给触发元素加上
data-bs-container="body"，强制 tooltip 挂载到下，脱离裁剪上下文 - 避免用
data-bs-container=".container"这类 class 选择器——若页面多个元素匹配，Bootstrap 只取第一个，行为不可控 - 如果用了
transform或clip-path的容器，即使没设overflow，也可能创建新层叠上下文并间接导致裁剪
动态内容更新后 tooltip 不刷新
Tooltip 的 title 内容只在初始化时读取一次。改 title 属性、或用 JS 改 el.title，已存在的 tooltip 实例不会响应。
- 想更新内容，必须先销毁再重建：
tooltip.dispose()（Bootstrap 5），再new bootstrap.Tooltip(el, { title: '新内容' }) - 如果要支持 HTML 内容，初始化时必须传
html: true，仅设data-bs-html="true"属性无效 -
tooltip('hide')后立即tooltip('show')会失效，因隐藏是异步的；应监听hidden.bs.tooltip事件，在回调里调用show - 移动端长按场景必须设
trigger="manual"，再用touchstart/touchend+setTimeout手动控制，原生不支持 long press
真正容易被忽略的点是：tooltip 的生命周期完全由 JS 实例管理，它不依赖 CSS 或属性监听，也不响应 DOM 变化。一旦你忘了在动态节点插入后重新初始化，或者在更新内容时只改了属性没 dispose，它就会静默失效——没有报错，也没有警告，只有悬停时那一片沉默。
