在 Layui 的 upload 组件中，默认的上传行为就是单文件模式——官方文档对此有清晰说明，开发者无需额外配置所谓的“限制”。然而，许多开发者仍然会遇到明明没有启用多选，却能够选择多个文件的困惑。这类问题通常源自两个方面：要么是 JavaScript 配置中无意开启了 `multiple: true`，要么是 HTML 中的 `` 标签携带了 `multiple` 属性，而 Layui 会主动读取该属性。  具体来说，常见引发多选的“隐形开关”主要有三种情形： - `upload.render()` 配置参数中明确写入了 `multiple: true` - HTML 内绑定的 `file` 类型 `` 元素自带 `multiple` 属性（Layui 会优先读取该属性） - IE9 及更低版本浏览器因缺少 `files` API，Layui 会降级处理，导致行为异常——不过官方早已停止维护这些老旧浏览器，可忽略不计 因此，排查思路非常明确：**JS 配置与 HTML 源码必须同时检查，只要任一位置残留 `multiple`，多选功能就会被触发。** 先看 JS 层面：可以在初始化参数中删除 `multiple: true`，或者直接省略该参数（默认值为 `false`），当然也可以显式设置为 `multiple: false` 以明确意图。 再看 HTML 层面：如果使用自定义触发元素（例如 ``），那么 DOM 中原本就不应存在 ``。但如果使用了 `bindAction` 或者直接编写了 ``，则需要手动移除 `multiple` 属性。 还有一个容易忽略的场景——在 `choose` 回调中自行累积文件。部分开发者希望实现“先选择再统一上传”的功能，于是在 `choose` 回调中将 `obj.files` 存入数组，每次选择时追加，从而造成了“可选择多个文件”的假象。这并非 Layui 的多选机制，而是自身缓存逻辑未及时清空所导致。 解决方案十分简单： - 避免在 `choose` 中编写 `selectedFiles.push(...)` 这类累加代码 - 若确实需要干预，直接使用 `obj.files[0]`，或定义变量 `selectedFile = obj.files[0]`，每次覆盖而非追加 - 如需用户二次确认，也应在 `choose` 中立即调用 `obj.upload()`，而非等到点击按钮时才发送 最后澄清一个常见误区：`auto: false` 与是否多选并无直接关联。该参数仅控制“选择文件后是否立即发起上传请求”，不影响选择阶段的行为模式。组合效果如下： - `auto: false` + `multiple: false` → 用户只能选择一个文件，点击上传按钮后才发送 - `auto: false` + `multiple: true` → 用户可以选择多个文件，但需自行处理批量上传逻辑 - 切勿认为关闭 `auto` 就能自动变为单文件——真正控制多选的开关是 `multiple` 总而言之，强制单文件上传的关键不在于“增加限制”，而在于“清除所有导致多选生效的痕迹”。其中最容易踩坑的是 HTML 层中隐蔽的 `multiple` 属性——它的优先级高于 JS 配置，且肉眼难以察觉。检查时，建议直接在整个项目中搜索 `multiple` 关键词，一搜即中。