show.bs.modal 事件必须绑定到模态框 DOM 元素而非 Modal 实例，且需确保元素已存在；该事件触发时 DOM 尚未渲染完成，适合轻量准备，禁止查子元素或初始化插件，应移至 shown.bs.modal 阶段；需防重复绑定，推荐使用 { once: true } 或统一初始化时绑定。
show.bs.modal 事件绑定必须作用于 DOM 元素，不能绑在 Modal 实例上
bootstrap 5+ 的 modal 类是纯 js 实例，不继承 eventtarget，所以 mymodal.addeventlistener('show.bs.modal', ...) 会直接报错 addeventlistener is not a function。正确做法是把事件监听器加到模态框的根 dom 节点（如 document.getelementbyid('mymodal')）上。
- ✅ 正确：
document.getElementById('myModal').addEventListener('show.bs.modal', handler) - ❌ 错误：
new bootstrap.Modal(...).addEventListener(...) - 如果模态框是动态插入（比如 AJAX 渲染后 append），确保监听代码执行时该 DOM 元素已存在，否则
getElementById返回null
show.bs.modal 触发时 DOM 尚未渲染完成，不适合查子元素或初始化插件
show.bs.modal 在模态框开始显示、但内容还没真正挂载进文档时触发。此时调用 querySelector 找按钮、表单或第三方组件容器，大概率返回 null 或空集合。
- 不要在这里执行
initSelect2(document.querySelector('.modal-body'))——.modal-body可能还是空的 - 也不适合读取
event.relatedTarget.dataset以外的动态数据，因为模态框主体内容可能还没替换 - 适合做轻量准备：记录来源按钮、设置 loading 状态、创建
AbortController实例等 - 真正操作 DOM 或初始化插件，请挪到
shown.bs.modal阶段
多次打开模态框时，show.bs.modal 监听器重复绑定导致逻辑执行多遍
如果每次调用 show() 前都重新 addEventListener('show.bs.modal', ...)，而没清理旧监听器，就会出现一次打开、事件回调执行 N 次的问题。
- 推荐加
{ once: true }：只响应第一次打开，适用于埋点、初始化全局状态等一次性动作 - 若需每次打开都执行（如加载不同 URL 内容），应在
hidden.bs.modal或关闭后手动removeEventListener - 更稳妥的做法是统一在页面初始化时绑定一次，靠
event.relatedTarget区分不同触发源 - 避免在
shown.bs.modal里再绑show.bs.modal，容易形成嵌套循环
show.bs.modal 里调用 preventDefault() 可以阻止模态框显示，但慎用
这个事件是可取消的，event.preventDefault() 能中断后续渲染流程，让模态框“卡住不动”。但实际业务中极少需要——它不等价于禁用按钮，而是彻底阻断 Bootstrap 的内部 show 流程。
- 常见误用：想防重复点击，就在
show.bs.modal里preventDefault()，结果用户点十次都没反应，且无任何 UI 提示 - 真正要防重复，应该禁用触发按钮本身，或加节流（throttle）逻辑
- 仅在强校验场景下使用，比如检查用户权限失败后同步阻止弹窗，并立刻
alert()或跳转 - 注意：阻止后，
shown.bs.modal和hide.bs.modal都不会触发
show.bs.modal 处理函数，很可能在模态框根本没显示出来时就执行了，而且执行了不止一遍。别急着往里面塞 fetch 或 initXXX，先确认你要操作的东西是不是已经挂在 DOM 上。
