shadeClose设为false不生效的根本原因是shade未显式配置，Layui仅在shade为非false且非0（如0.3）时才读取shadeClose；必须同时设置shade:0.3和shadeClose:false，缺一不可。
shadeClose 设为 false 为什么还不生效
根本原因不是 shadeclose 失效，而是它压根没被触发——shade 没显式配置。layui 内部逻辑是：只有 shade 值为非 false 且非 0（比如 0.3）时，才会读取 shadeclose 的值。
常见错误写法：{ shadeClose: false } → 遮罩不渲染，shadeClose 被忽略
- 正确写法必须同时带
shade：{ shade: 0.3, shadeClose: false } -
shade: 0和shade: false效果不同：0仍生成 DOM（隐身但占位），false则完全不创建遮罩元素 - 拼写必须是
shadeClose，写成shadeclose或shade_close会静默失败
Vue/React 项目中点击遮罩仍关闭
框架的响应式机制或 DOM 生命周期干扰了 layer 的事件绑定时机，导致 shadeClose: false 在实际渲染时未生效。
- 确保
layer.open()在组件挂载后调用（Vue 的mounted/ React 的useEffect） - 避免把
layer.open()放在模板的响应式表达式里（如v-if="show"中直接调用） - 每次打开都需重新传入完整配置，
shadeClose: false不继承全局设置 - 检查是否用了
layer.closeAll()，它会无差别清空所有实例，包括你刚打开的
layer.msg / layer.alert 点击遮罩还是关了
这些快捷方法内部默认启用 shadeClose: true，且不读取你对 layer 对象的全局修改。
- 必须显式覆盖：
layer.msg('提示', { shadeClose: false }) -
layer.alert、layer.confirm同理，每个调用都要单独加{ shadeClose: false } - 特别注意
layer.msg的time参数：time: 0且shadeClose: true时，用户唯一退出方式就是点遮罩——这容易被误认为是 bug
移动端遮罩点击失效或偶发关闭
iOS Safari 和部分安卓 WebView 对 click 事件监听不稳定，尤其在快速滚动后点击遮罩边缘，事件可能被吞掉或延迟触发。
- 升级到 Layui v2.9.13+，新版修复了 touch/click 竞争问题
- 避免用
$('.layui-layer-shade').on('click')，遮罩 DOM 是动态生成的，外部委托易绑错 - 更稳妥的做法是在
success回调里精准获取当前遮罩：$(layero).prev('.layui-layer-shade') - 若用了自定义 CSS，请确认
.layui-layer-shade的z-index高于其他浮层（如 Element Plus 的el-dialog），否则点击实际落在上层 DOM 上
shadeClose: false，而是当多个弹层嵌套、或父容器设置了 pointer-events: none 时，点击行为会穿透到下层，看起来像“点了遮罩却关了窗”——其实关窗的不是遮罩，是底下某个被穿透的按钮或全局监听。 
