必须在form.on('submit(...)')回调第一行调用e.preventdefault()，否则页面必然刷新；该操作精准阻止默认提交，不干扰事件冒泡，是layui异步提交的前提。
必须在 form.on('submit(...)') 回调函数第一行调用 e.preventDefault()，否则页面必然刷新。 这不是可选项，而是 Layui 表单异步提交的前提。Layui 的 form.on 只是监听原生 submit 事件，并不自动阻止默认行为。
为什么 return false 不够稳定
虽然 return false 在多数情况下也能阻止跳转，但它同时会停止事件冒泡和后续监听器执行——如果你后续绑定了其他 submit 监听（比如全局日志、埋点），会被意外中断。而 e.preventDefault() 精准只阻止表单默认提交动作，语义清晰、兼容性好。
- 错误写法：
form.on('submit(filter)', function(data) { $.ajax({...}); return false; })—— 若 AJAX 前抛错，return false不会执行，页面照常刷新 - 正确写法：
form.on('submit(filter)', function(e) { e.preventDefault(); $.ajax({...}); })—— 阻止动作在最前，不受后续逻辑影响 - 注意参数名：回调函数必须声明事件参数（如
e或event），否则无法调用preventDefault
form.on 提交后页面仍刷新的常见原因
即使写了 e.preventDefault()，页面还是跳转，大概率是以下情况之一：
- HTML 中表单缺少
lay-filter属性，导致form.on根本没绑定上，走的是浏览器原生提交 - 重复引入了
layui.js（比如又加载了layui.all.js），造成form.on绑定多次，其中某次未加preventDefault - 表单内有多个
type="submit"按钮，但监听的lay-filter和实际点击按钮所属表单不匹配 - 使用了
form.submit('filter-name')手动触发，但对应form.on('submit(filter-name)')回调里漏掉了e.preventDefault()
配合 AJAX 提交时的典型结构
阻止刷新只是第一步，真正要完成无跳转交互，还得把数据发出去并处理响应：
form.on('submit(save-form)', function(e) {
e.preventDefault(); // 第一行！必须
var field = e.field; // 自动序列化为对象，比 $(this).serialize() 更可靠
$.ajax({
url: '/api/save',
type: 'POST',
data: field,
dataType: 'json',
success: function(res) {
if (res.code === 0) {
layer.msg('保存成功', { icon: 6 });
// 可选：重置表单或关闭弹窗
}
},
error: function() {
layer.msg('请求失败', { icon: 5 });
}
});
});
注意：不要在 success 外层直接写 layer.msg，否则它会在请求发出后立刻执行，而非等响应回来。
容易被忽略的兼容细节
移动端或某些 WebView 下，submit 事件可能由 touchend 触发，而 e.preventDefault() 对 touch 事件无效——但这里不需要额外处理，因为表单的 submit 是由内部 click 或回车最终触发的，只要确保该事件被拦截即可。真正要小心的是：如果同时监听了 keydown（比如 Ctrl+Enter 提交），那个监听里也得单独调 e.preventDefault()，否则可能绕过 form.on 直接触发原生提交。
