Bootstrap Tooltip默认不自动初始化，必须显式调用new bootstrap.Tooltip()；需确保加载bootstrap.bundle.min.js、DOM就绪后执行初始化、元素含data-bs-toggle="tooltip"和title属性，并注意动态元素需单独初始化。
Bootstrap 的工具提示框（Tooltip）默认不自动初始化，直接写 data-bs-toggle="tooltip" 不会生效——必须手动调用 bootstrap.Tooltip 初始化，这是最常被卡住的一步。
为什么加了 data 属性却没弹出提示？
Bootstrap 5+ 移除了自动初始化逻辑，所有 Tooltip 必须显式启用。常见错误是只写了 HTML 属性，忘了 JS 初始化。
- 确保已正确引入 Bootstrap CSS 和 JS（含 Popper.js，通常通过
bootstrap.bundle.min.js一次性加载） - 初始化代码必须在 DOM 加载完成后执行，否则找不到元素
- 不能在
中立即运行初始化，推荐放在DOMContentLoaded或$(document).ready()（如果用了 jQuery）
最小可行示例：
<button type="button" class="btn btn-secondary" data-bs-toggle="tooltip" data-bs-title="这是一个提示">悬停我</button>
<script>
document.addEventListener('DOMContentLoaded', function () {
const tooltipTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="tooltip"]'))
tooltipTriggerList.map(function (tooltipTriggerEl) {
return new bootstrap.Tooltip(tooltipTriggerEl)
})
})
</script>
怎么控制 Tooltip 的位置和触发方式？
位置由 data-bs-placement 控制，默认是 "top"；触发方式靠 trigger 选项，默认 "hover focus"，不支持 click 单独触发（需手动配置）。
- 合法 placement 值：
"top"、"right"、"bottom"、"left"（注意不是"left"拼错成"leftt"） - 若想仅点击触发：初始化时传入
{ trigger: 'click' }，且需确保元素可聚焦（如加tabindex="0"） - 移动端无 hover，
focus触发对屏幕阅读器更友好，但需搭配tabindex
例如右对齐 + 点击触发：
<span tabindex="0" data-bs-toggle="tooltip" data-bs-title="右侧提示" data-bs-placement="right">点我</span>
<script>
new bootstrap.Tooltip(document.querySelector('[data-bs-toggle="tooltip"]'), {
trigger: 'click'
})
</script>
如何动态更新 Tooltip 内容或销毁实例？
Tooltip 实例挂载在 DOM 元素上，可通过 bootstrap.Tooltip.getInstance(el) 获取；内容更新不能直接改 data-bs-title，得调用 setContent() 方法。
- 更新内容：先获取实例，再调用
setContent({ '.tooltip-inner': '新文字' }) - 销毁实例：调用
dispose()，否则可能造成内存泄漏或重复绑定 - 重新启用：销毁后需再次
new bootstrap.Tooltip(el) - 注意：
title属性会被 Tooltip 自动清空，别依赖它存原始文本
动态更新示例：
const el = document.querySelector('[data-bs-toggle="tooltip"]')
const tooltip = bootstrap.Tooltip.getInstance(el)
if (tooltip) {
tooltip.setContent({ '.tooltip-inner': '已刷新的内容' })
}
容易忽略的是：Tooltip 的 z-index 默认是 1070，如果父容器有 overflow: hidden 或 transform，可能导致提示框被裁剪——这时得检查父级样式，而不是调大 z-index。
