正确配置 layer.msg 不自动消失应设 time: 0；需点击遮罩关闭时须配 shade: [0.2, '#000'] 和 shadeclose: true；避免使用 time: -1 等非标准写法；hover 暂停需手动实现并注意 dom 生命周期；关闭后操作需监听 end 事件。
layer.msg 不自动消失的正确配置方式
直接设 time: 0 或 time: false 都无效——layui 2.8+ 中，time 默认就是 0（永不关闭），但必须显式传入才生效；不写 time 参数时，行为反而不确定，尤其在旧版兼容场景下容易出错。
-
time: 0是唯一被官方支持的「禁用自动关闭」写法，不是false、null或省略 - 如果同时需要点击遮罩关闭，必须配
shade: [0.2, '#000']+shadeClose: true，否则遮罩不可点 -
shade: 0会隐藏遮罩，此时shadeClose: true失效，用户只能靠脚本或 closeBtn 关闭 - 返回的 layer index 可用于后续手动调用
layer.close(index)，别丢了这个值
为什么 time: -1 也能用但不推荐
部分老项目或社区示例里写 time: -1 确实能阻止自动关闭，但这属于未公开的内部逻辑绕过，不是 API 正式支持的行为。Layui 源码中对 time 的处理是：if (time > 0) { 启动定时器 }，所以 -1 和 0 效果相同，但语义模糊、易误导新人，且未来版本可能调整判断逻辑。
- 文档和类型定义（如 TypeScript 声明）只标注
number，未说明负值含义 - 团队协作时，
time: 0更易被理解为「零秒关闭」即「不关」，符合直觉 - 某些定制版 Layui 或二次封装库会过滤掉负值，导致意外恢复自动关闭
想鼠标悬停暂停关闭，得自己加事件监听
layer.msg() 本身不提供 hover 暂停机制，所谓「悬浮保持」只是开发者自己用 JS 实现的临时方案：启动定时器 → 鼠标移入时 clearTimeout → 移出时重置定时器。但要注意 DOM 生命周期问题。
- 不能直接给
.layui-layer-msg绑事件，因为提示框 DOM 可能在你绑定前已销毁，或关闭后立刻被移除 - 稳妥做法是在
success回调里操作：success: function(layero) { layero.on('mouseenter', () => clearTimeout(timer)); } - 必须保存
setTimeout返回的 timer ID，且在layer.close()前手动清理，避免内存泄漏 - 用户切走标签页时，
setTimeout会被浏览器节流，实际延迟远超预期，别依赖它做精确控制
容易被忽略的关闭时机陷阱
很多人以为 layer.close(index) 执行完提示框就立刻消失，其实它触发的是异步销毁流程，DOM 移除有动画延迟。如果你紧接着操作相关 DOM（比如清空表单、跳转路由），大概率报错。
- 回调函数在关闭「动作发起瞬间」执行，不是动画结束时，也不是 DOM 移除后
- 想等 DOM 真正消失？得监听
layer的end事件：layer.ready(() => { /* 初始化后 */ });不适用，要用原生transitionend或 setTimeout 延迟 - 连续快速调用
layer.msg()时，上一个还没关，新弹窗就叠上来——没做防抖的话，用户看到的就是多个层堆在一起 - 页面卸载（如
location.href = 'xxx'）前没手动layer.close()，残留的 layer 可能引发内存泄漏或报错
