百度地图覆盖弹出层的根本原因是z-index层级冲突与堆叠上下文断裂，需同步修复堆叠上下文和z-index优先级：为地图容器添加transform: translateZ(0)使其进入body顶层上下文，并为layer弹窗设置appendTo: 'body'及更高zIndex，同时显式提升.baidu-map-sug的z-index至3001以上。
弹出层被百度地图覆盖，本质是 z-index 层级冲突 + stacking context 断裂，不是单纯调高 layer 的 z-index 就能解决。
为什么百度地图的下拉提示或地图容器会盖住 layer 弹窗
百度地图的 BMap.Autocomplete 下拉列表、气泡、控件等默认插入到 document.body 底层，但它的容器（如 #mapContainer）往往设置了 position: relative 或带 transform 的 wrapper，这会创建独立 stacking context；而 layer 默认也插入 body，但若父页面存在 transform: translateZ(0)、filter 或 opacity < 1 等属性，layer 就会被“困”在低层级 context 内，再高的 zIndex 也穿不透。
- 常见现象：
BMap.Autocomplete下拉框只显示顶部几行，或整个地图 div 盖住了 layer 弹窗标题栏 - 错误尝试：只给
layer.open({ zIndex: 9999 })—— 无效，因为不在同一 stacking context - 关键线索：检查
getComputedStyle(document.body).transform和父级 wrapper 是否有will-change、filter
必须同时修复 stacking context 和 z-index 优先级
光改一个地方大概率失败。要同步做两件事：
- 让百度地图相关 DOM 节点脱离原 context：给地图容器加
style="transform: translateZ(0); position: relative; z-index: 1;"，强制它进入 body 的顶层 context - 让 layer 弹窗明确处于更高 context：在
layer.open()中传入{ appendTo: 'body', zIndex: 3000 }（Layui ≥2.8 支持appendTo） - 若用的是旧版 Layui（<2.8），需手动 patch：
layer.config({ skin: 'layui-layer-mapfix' })，并在 CSS 中加.layui-layer-mapfix { z-index: 3000 !important; }
Autocomplete 下拉框被遮挡的专项处理
BMap.Autocomplete 的下拉列表（.baidu-map-sug 类）是动态追加到 body 的，但它默认 z-index: 1，远低于 layer 的 1989。必须显式覆盖：
调用百度PaddleOCR‑VL大模型API，支持PDF、Word、PPT、图片等多格式文档解析，精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素，支持100+语言，可处理不规则布局和跨页长文档。触发词：文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。
- 在全局 CSS 中添加：
.baidu-map-sug { z-index: 3001 !important; } - 不要用 JS 动态设 style，因为百度地图可能多次重绘下拉框，内联样式易丢失
- 如果项目用了 scoped CSS 或 Shadow DOM，需确保该样式能穿透到
body下的节点（可用:global(.baidu-map-sug)或直接写在 index.html 的<style>里）
地图容器在 layer 弹窗内显示不全的根源与解法
当把 <div id="tmsbaiduMap"></div> 放进 layer.open({ type: 1 }) 的 content 里时，常出现地图空白或缩放错位——这不是百度地图问题，是 layer 弹窗内容区默认 overflow: auto 截断了地图 canvas 渲染区域。
- 必须在弹窗 success 回调中重置容器 overflow：
layero.find('#tmsbaiduMap').parent().css('overflow', 'visible') - 地图初始化前确保容器有宽高：
$('#tmsbaiduMap').css({ width: '100%', height: '400px' })，不能依赖父级自适应 - 初始化地图后调用
map.resize()，否则地图控件可能错位
真正麻烦的从来不是 z-index 数值本身，而是 stacking context 的嵌套链是否连通。一旦父页 layout 区域加了 transform 或 filter，所有子元素的定位都会被“关小黑屋”，这时候再调 zIndex 就像往瓶子里倒水——倒再多，也漫不出瓶口。
