Layui upload 组件默认单文件选择，无需额外限制；若出现多选现象，通常因配置了 multiple: true、HTML 中 input 标签含 multiple 属性、choose 回调中重复缓存文件或 IE9- 兼容性退化导致。
layui
upload 组件默认就是单文件选择，不用额外限制
很多人以为要加什么参数才能“禁止多选”，其实
layui.upload
默认行为就是只允许选一个文件——前提是没手动开启
multiple
。浏览器原生的
在没加
multiple
属性时，系统文件选择器天然就只让你勾一个。
所以真正的问题往往不是“怎么限制”，而是“为什么看起来能选多个”：
你可能在初始化 upload 时传了
multiple: true
或者 DOM 上的
标签本身带了
multiple
属性（Layui 会读取它）
也可能是用了
choose
回调里手动 push 到数组，造成“累积上传”的错觉
检查并清除 multiple 相关配置
最直接的办法是翻你初始化 upload 的代码，确认没有主动启用多选：
layui.upload({
elem: '#uploadBtn',
url: '/upload',
// ✅ 确保这里没有写 multiple: true
// ✅ 也不要有 auto: false + 手动触发多次 choose 的逻辑
done: function(res){
console.log('只上传了一个：', res);
}
});
同时检查 HTML 中对应按钮或隐藏 input：
如果用的是自定义触发元素（比如
），那 DOM 里不需要
，自然不会有多选问题
如果用了
bindAction
或显式写了
，务必确认它没带
multiple
属性
避免在 choose 回调里重复绑定或缓存文件
有人想“先选再统一上传”，于是在
choose
回调里把
obj.files
存起来，结果发现每次选都追加——这是因为
obj.files
是 FileList，而 Layui 每次触发
choose
都是全新实例，但你的变量没清空。
正确做法很简单：
基于Layui自定义内容轮播插件
基于Layui自定义内容轮播插件是一款表格数据为ajax加载的本地json数据，本地查看会有跨域问题导致数据不能显示。
下载
不依赖
choose
回调做文件暂存，让 Layui 自己处理单次选择流
真要干预，也在
choose
里立刻调用
obj.upload()
，不要留接口等二次点击
如果必须手动控制，那就每次
choose
先清空已有引用：
selectedFile = null; selectedFile = obj.files[0];
注意 IE9 及以下的兼容性假象
Layui 官方已不支持 IE9-，但如果你还在维护老项目，要注意：IE9 的 file input 不支持
files
API，
obj.files
是 undefined，此时 Layui 会退回到 form submit 模式——而这个模式下用户点几次按钮就发几次请求，看起来像“能传多个”，其实是多次独立提交。
这种情况下：
无法靠前端 JS 限制“只能选一个”，因为底层机制不同
后端必须对重复请求做幂等判断（比如校验文件名、大小、MD5）
更现实的做法是明确提示“请使用 Chrome / Firefox / Edge 浏览器”
现代浏览器里，只要没碰
multiple
，用户点一次选择框，就只能勾一个文件——这个限制来自操作系统级文件对话框，Layui 只是顺手用了它。
