Layui表单用serializeArray()转对象需先确保控件有name属性并已渲染，再遍历数组手动合并为对象，自动兼容单值与多值字段。
layui 表单如何用 serializeArray() 转成对象
layui 本身不提供直接把表单转为嵌套对象（如 {name: "张三", age: 25}）的 API，但可以复用 jQuery 的 serializeArray()，再手动归并为对象。注意：必须确保 layui 表单已渲染（即 form.render() 已执行），否则动态生成的 select、checkbox 等控件值可能取不到。
常见错误是直接对 form 元素调用 serializeArray() 却没加 name 属性——layui 所有表单控件（包括 lay-select 渲染后的 select）都**必须显式设置 name 属性**，否则不会被序列化。
- 给每个表单项加上
name="username"、name="status"等合法 name 值 - 多选
checkbox要统一name（如name="hobby"），否则只会取第一个勾选项 - 如果用了
lay-verify="required"但没设name，校验会生效，但提交时该字段根本不会进序列化结果
怎么把 serializeArray() 结果转成纯对象
serializeArray() 返回的是形如 [{name:"a", value:"1"}, {name:"b", value:"2"}] 的数组，需手动映射。不要用 JSON.parse(JSON.stringify(...))，那只是深拷贝，不是结构转换。
最简健壮写法：
var formData = {};
layui.$('form').serializeArray().forEach(function(item) {
// 处理同名多值（如多选 checkbox）
if (formData[item.name] !== undefined) {
if (!Array.isArray(formData[item.name])) {
formData[item.name] = [formData[item.name]];
}
formData[item.name].push(item.value);
} else {
formData[item.name] = item.value;
}
});
这个逻辑能自动兼容单值和多值字段，比 layui.$.param() 或 new FormData() 更可控——后者在上传文件或需要严格类型（如数字/布尔）时反而要额外 parse。
遇到 checkbox/radio 不生效？检查 layui 渲染后的真实 DOM
layui 会把 <input type="checkbox" name="agree"> 替换为隐藏域 + 自定义 UI，但**真实表单值仍由原 input 元素承载**。所以只要原始 HTML 中 input 有 name 且被正确 checked，serializeArray() 就能取到。
容易踩的坑：
- 用
layui.form.on('switch')改变状态后，忘了同步原input的checked属性（应调用elem.prop('checked', true)） - 动态添加的 checkbox 没调用
form.render('checkbox')，导致 DOM 未绑定事件和值映射 - 把
name写在了div class="layui-form-checkbox"上，而不是内部input标签上
ajax 提交前直接用 layui.form.val() 更省事？
可以，但要注意：layui.form.val('example') 只返回「当前已渲染表单」的值，且**仅支持 layui 内置控件（select / checkbox / radio / switch / slider）**；对原生 input[type=text]、textarea 等，它默认忽略，除非你手动用 form.val('example', {key: val}) 注入过。
所以更稳妥的做法是混用：
- 先用
layui.form.val('yourFilter')拿 layui 控件的值 - 再用
layui.$('form :input[name]').serializeArray()补全原生字段，并合并去重 - 避免只依赖一种方式，尤其当表单混用自定义组件和原生 input 时
真正麻烦的不是序列化本身，而是表单字段命名是否统一、多值字段是否按预期聚合、以及动态渲染后 DOM 状态与数据是否始终同步——这些细节漏掉一个，后端收到的就可能是残缺或错位的数据。
