Bootstrap Popover需手动初始化且依赖Popper，常见问题包括未调用初始化、动态元素未重绑定、HTML内容未启用data-bs-html="true"、hover触发在触摸设备失效、定位错乱源于transform/overflow干扰。
Bootstrap Popover 不是“做个提示框”就完事的组件，它本质是个带定位、带生命周期、需手动初始化的交互容器。直接写 data-bs-toggle="popover" 但没调用 bootstrap.Popover 初始化，或者在动态插入的元素上漏了重新绑定，90% 的“不显示”问题都出在这儿。
为什么 data-bs-toggle="popover" 写了却没反应
Bootstrap 5 默认不自动初始化 Popover —— 它只监听 DOMContentLoaded 时已存在的元素，且要求你显式启用。
- 必须引入
bootstrap.bundle.min.js（含 Popper），不能只引bootstrap.min.js - HTML 中写了
data-bs-toggle="popover"，但 JS 没执行初始化：const popoverTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="popover"]')); popoverTriggerList.map(function (popoverTriggerEl) { new bootstrap.Popover(popoverTriggerEl); }); - 动态生成的按钮（比如 Ajax 后追加的）不会被自动捕获，得手动对新节点调用
new bootstrap.Popover(el) -
data-bs-trigger="hover"在触摸设备上默认禁用，真要支持 hover+touch，得自己监听touchstart并切换触发逻辑
data-bs-content 里塞 HTML 总被转义或报错
默认情况下，Popover 把 data-bs-content 当纯文本处理，<strong></strong> 会原样显示，而不是加粗；更糟的是，如果内容里有双引号（比如 <a href="xxx"></a>），HTML 解析器直接报错或截断。
- 必须加
data-bs-html="true"才允许解析 HTML - 属性值要用单引号包裹：
data-bs-content='<strong>注意</strong>：点击后将提交'，避免内外双引号冲突 - 如果内容来自 JS 变量，别拼字符串，改用 JavaScript 初始化方式传入：
new bootstrap.Popover(el, { content: '<button class="btn btn-sm">确认</button>', html: true }) - 注意 XSS 风险：
html: true下，若 content 来自用户输入，必须先做 HTML 转义（如用DOMPurify.sanitize()）
悬停后鼠标移进 Popover 就消失，怎么留住
原生 Popover 的 trigger="hover" 是“悬停触发 + 离开立即隐藏”，没有防抖或区域合并逻辑，所以鼠标一离开按钮、还没进 Popover 就关了。
- 官方不提供“悬停保持”选项，得自己 hack：监听
shown.bs.popover事件，给.popover加mouseenter/mouseleave，并用setTimeout控制 hide 延迟 - 更稳妥的做法是改用
trigger="manual"，完全由 JS 控制 show/hide，配合mouseenter和mouseleave自定义进出逻辑 - 别依赖
delay参数解决这个问题：delay只控制 show/hide 的起始延迟，不阻止“移出按钮即触发 hide”这个行为
Popover 定位错乱或箭头偏移
Popper.js 负责定位，但它依赖父容器的 CSS 层叠上下文和定位上下文。常见错位不是 Popover 本身 bug，而是布局干扰。
- 触发元素如果在
transform、perspective或filter容器内，Popper 会计算错误 —— 给该父容器加contain: layout paint或移出 transform - Popover 被
overflow: hidden的祖先裁剪？检查最近的有 overflow 的父级，加position: relative或临时改overflow: visible - 箭头（
.popover-arrow）位置不准，大概率是 CSS 覆盖了top/left的计算值，不要直接设.popover-arrow { top: 10px }，改用--bs-popover-arrow-height等 CSS 变量微调 - 小屏下 placement 自动调整失败？确保没禁用 Popper 的
flip选项（默认开启），JS 初始化时别传fallbackPlacements: []
真正难的不是让 Popover 显示出来，而是让它在各种嵌套、滚动、缩放、动态加载场景下稳定响应 —— 这些地方没文档细说，但线上一崩就是白屏或错位，得靠 DevTools 逐层查 offsetParent、getBoundingClientRect 和 Popper 的 modifiers 日志。
