直接改 .popover 的 max-width 不生效，需先检查 container 是否为 body 以避免父容器 overflow/transform 限制；再确认 content 无空格长串导致不换行；最后用 popperConfig 调整箭头定位。
直接改 .popover 的 max-width 不生效？优先检查 container
Bootstrap 5 的 Popover 默认会 append 到触发元素的 parentNode，如果这个父容器有 overflow: hidden、transform 或 position: relative，Popper.js 计算尺寸时就会受限——此时你写的 max-width: 600px 可能被父容器裁掉，或者根本没机会撑开。最常见现象是：CSS 写了但弹窗还是窄窄的一条，内容换行、挤在一起。
解决方法不是加 !important，而是先确保渲染上下文干净：
- 初始化时显式传
{ container: 'body' }，或 HTML 中写data-bs-container="body" - 避免在
modal、dropdown-menu、table td这类带干扰样式的容器内直接初始化 Popover - 确认没有其他 CSS 规则（比如父级
max-width或width）意外传导到.popover上
max-width 生效但内容仍不展开？检查 template 和 html 配置
Popover 的实际宽度受两层限制：一是 CSS 的 max-width，二是内部内容容器（即 .popover-body）的默认 white-space: normal 行为。如果 content 是长字符串无空格（如 base64、UUID、JSON 片段），浏览器不会自动折行，导致内容溢出、滚动条出现，视觉上“还是窄”。
这时要配合调整内容区域样式：
立即学习“前端免费学习笔记（深入）”；
- 确保启用
html: true（否则<div style="word-break:break-all">会被当纯文本） - 自定义
template，把.popover-body的换行策略显式写死：template: '<div class="popover" role="tooltip"><div class="popover-arrow"></div><h3 class="popover-header"></h3><div class="popover-body" style="word-break:break-word; overflow-wrap:break-word;"></div></div>' - 不推荐只靠
white-space: pre-wrap，它对中文/数字串效果不稳定
用 container: 'body' 后宽度正常了，但箭头错位或弹窗飘走？
挂到 body 下解决了宽度限制，但也带来新问题：Popper.js 的参考系变了，箭头可能指向错误位置，尤其当触发元素在滚动区域或固定定位容器中时。
这不是 CSS 能修的，得靠 popperConfig 微调计算逻辑：
- 加
adaptive: false防止因父级transform导致坐标系偏移：popperConfig: { modifiers: [{ name: 'computeStyles', options: { adaptive: false } }] } - 禁用自动 fallback（比如从
bottom跳到top）：{ name: 'flip', enabled: false }，但前提是确认目标方向一定有足够视口空间 - 首次显示后手动触发更新（适用于异步内容）：
element.addEventListener('shown.bs.popover', () => element popover.update())
为什么行内 style="max-width: 600px" 没用？
因为 Bootstrap 的 Popover DOM 是动态插入的，你写的行内样式作用在触发元素（比如 <button>）上，完全不作用于生成的 <div class="popover">。有人试过给触发元素加 padding-right “假装变宽”，那是错觉——只是把触发点右移了，弹窗本身尺寸没变。
真正起效的方式只有两个：
① 在全局 CSS 中覆盖 .popover { max-width: 600px; }，且确保该规则优先级 ≥ Bootstrap 原生 CSS（比如加 !important 或放在引入 bootstrap.css 之后）；
② 用 template 把 max-width 写进弹窗根元素的内联样式里（不推荐，维护性差）。
复杂点在于：宽度不是孤立参数，它和 container、popperConfig、内容格式强耦合。改一个地方，往往要同步调另外两个，否则不是撑不开，就是飘走或换行异常。
