必须等 DOM 就绪再延时弹出，否则 document.getElementById('myModal') 返回 null 导致 show() 报错；需包裹在 DOMContentLoaded 中、确保 Bootstrap JS 已加载、避免重复初始化、并在内容就绪后再显示。
延时弹出必须等 DOM 就绪，否则 document.getElementById('myModal') 返回 null
直接写 setTimeout(() => { new bootstrap.Modal(...).show(); }, 2000) 很大概率报错：Cannot read properties of null (reading 'show')。因为脚本若在 <head> 中执行，此时 DOM 还没解析完，getElementById 拿不到元素。
- 必须把整个逻辑包在
document.addEventListener('DOMContentLoaded', ...)里 - 确保
bootstrap.bundle.min.js已加载（含 Popper 和 Bootstrap JS），不能只引 CSS - 如果模态框是动态插入（如 AJAX 加载），得等插入完成后再初始化，不能只靠 DOMContentLoaded
new bootstrap.Modal() 不能重复调用同一个元素
同一 DOM 节点多次执行 new bootstrap.Modal(el)，第二次会直接抛错：Modal is already initialized。延时逻辑里没做保护，很容易踩坑。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 初始化前先检查是否已有实例：可用
el.getAttribute('data-bs-modal-instance')或自己维护一个 Map 缓存 - 更稳妥的做法是只查一次元素、只建一次实例，延时后复用：
const modalEl = document.getElementById('myModal'); const modal = new bootstrap.Modal(modalEl); setTimeout(() => modal.show(), 2000); - 如果页面有多个模态框，别全局用同一个变量名，避免覆盖
内容为空或黑底但没内容？大概率是 show() 太早了
Modal 黑底出来了，但 body 里啥也没有——不是 JS 没跑，而是内部依赖的异步数据或第三方组件（如 Select2、日期控件）还没就绪。
- 不要在
DOMContentLoaded后立刻show()，尤其当 Modal 内容需fetch加载时 - 推荐监听
show.bs.modal事件，在它触发时再拉数据、再初始化子组件 - 若必须延时，把延时和数据加载解耦：先 show，再在
shown.bs.modal里处理内容；或延时后手动fetch+innerHTML+ 初始化
Vue/React 里延时弹出要多等一层渲染
在 mounted 或 useEffect 里调 show()，仍可能因 DOM 没真正挂载而失败。
- Vue：加
nextTick或setTimeout(..., 0)确保模态框节点已渲染 - React：用
useEffect+ref拿到 DOM 节点，再套一层setTimeout，别用useState控制显隐替代 JS 初始化 - SSR 场景下，服务端不执行 JS，
show()只能在客户端生命周期里触发
