layui upload 的 multiple 预览顺序错乱是因为其内部用 for...in 遍历 FileList 导致索引无序；应通过 obj.originEvent.target.files 获取原始有序文件，手动创建预览并串行上传以保证三端顺序一致。
layui upload 的 multiple 属性开启后为什么预览顺序会乱？
因为 layui 2.8.x 及之前版本的 upload.render() 在多文件选择时，choose 回调中返回的 obj.pushFile() 是异步触发的，浏览器原生 input[type="file"].files 虽然保持顺序，但 layui 内部用 for...in 遍历 FileList（类数组），而 for...in 不保证索引顺序，导致后续预览插入 DOM 时错位。
解决思路不是改 layui 源码，而是绕过它的内部排序逻辑，自己控制文件列表和预览渲染顺序：
- 在
choose回调里立刻用Array.from(input.files)获取有序的原始文件数组 - 清空 layui 的内部缓存：
obj.config.elem.next().empty()（假设你用的是默认预览容器） - 手动按顺序创建
data-file-index或闭包变量里备用 - 上传时用
obj.upload(index, file)显式逐个上传，确保顺序与预览一致
怎么用 choose 回调拿到严格顺序的文件并生成预览？
别依赖 obj.files —— 它已被 layui 处理过、顺序不可靠。直接从事件源抓：
upload.render({
elem: '#upload',
url: '/api/upload',
multiple: true,
choose: function(obj) {
// ✅ 正确获取原始顺序
const files = Array.from(obj.originEvent.target.files);
// ✅ 清空旧预览（避免重复）
const previewBox = $('#preview-box');
previewBox.empty();
// ✅ 按顺序生成预览 img，并绑定 data-index
files.forEach((file, index) => {
if (!file.type.match('image.*')) return;
const reader = new FileReader();
reader.onload = function(e) {
const $img = $(`@@##@@`);
previewBox.append($img);
};
reader.readAsDataURL(file);
});
},
done: function(res, index, upload) {
console.log('第 ' + index + ' 个文件上传完成');
}
});
注意：obj.originEvent 是 layui 2.7+ 提供的原始事件对象，低版本需改用 obj.item 或监听 input 的 change 事件自行接管。
上传时如何确保服务端接收顺序和预览顺序一致？
layui 默认并发上传，无法保证服务端接收顺序。必须改成串行上传，并显式传入 index：
- 在
choose后保存files到闭包或组件实例上（如window.pendingUploads = files） - 禁用自动上传：
auto: false，然后绑定按钮点击触发upload.start()的变体 - 用递归或
async/await控制上传节奏，每次只传一个，并把index和对应file传给obj.upload(index, file) - 服务端接口需支持
sort_order字段（或靠请求顺序判断），否则仅靠文件名/时间戳无法还原前端顺序
示例关键片段（配合上面的 choose）：
let pendingFiles = [];
// choose 中赋值：pendingFiles = Array.from(obj.originEvent.target.files);
$('#start-upload').on('click', function() {
function uploadNext(i) {
if (i >= pendingFiles.length) return;
obj.upload(i, pendingFiles[i]);
}
uploadNext(0); // 第一个开始
obj.on('done', function(res, index) {
uploadNext(index + 1); // 上传完下一个
});
});
预览区域滚动、缩略图尺寸、删除重排怎么同步顺序？
预览图是手动插入的，删除时不能只删 DOM，还要同步维护两个东西：文件数组索引映射、以及后续上传的序号对齐。
- 每个
data-index，点击删除时用它定位待删文件 - 删除 DOM 后，用
splice()从pendingFiles中移除对应项，并重新给剩余data-index赋值（否则上传时 index 错位） - 缩略图建议统一用 CSS 控制尺寸（
object-fit: cover），避免 JS 计算宽高失真 - 如果预览区加了
overflow-y: auto，记得删除后调用previewBox[0].scrollIntoView({block: 'nearest'})保持可视区域稳定
顺序问题最易被忽略的点：你以为只是展示顺序，其实牵扯到文件对象引用、上传队列索引、服务端入库顺序三者对齐。少一环，上线后就出现“用户说第一张图传错了”这种难复现的问题。
