必须加multiple属性,否则浏览器原生禁止多选;加了仍单选的主因是漏设enctype="multipart/form-data"、name未用数组形式(如files[])、method非post、ios safari 16.3及更早版本静默忽略multiple。

必须加 multiple 属性,否则浏览器原生禁止多选——这不是 JS 能绕过的限制,是渲染层硬性规则。
为什么加了 multiple 还是只能选一个文件
大概率漏了以下任一硬性条件:
-
enctype="multipart/form-data"没写在<form></form>标签上——没它,文件数据根本不会发出去 -
name写成name="files"而非name="files[]",导致 PHP 等后端只保留最后一个文件的$_FILES['files']['name']值 - 表单
method不是POST——GET无法携带二进制文件 - iOS Safari 16.3 及更早版本会静默忽略
multiple,input.files.length永远为 1,且无任何提示或报错
input.files 是类数组,不是数组
直接对 input.files 调用 .forEach() 或 .map() 会报 TypeError: not a function,因为它是只读的 FileList 对象。
- 安全转真数组:用
Array.from(input.files)或[...input.files] - 别用
input.value获取文件名——它只返回伪造路径(如C:\fakepath\photo.jpg),对多文件无效 - 每个
file是File实例,有name、size、type、lastModified,但file.path在所有现代浏览器中都是undefined - 调试时别
JSON.stringify(input.files)——结果是空对象,FileList不可序列化
用 FormData 上传多个文件时,append 的 key 名怎么写
后端能否收到全部文件,取决于你往 FormData 里怎么填 key:
- ✅ 正确:对每个文件都用相同 key 多次
append,例如formData.append('files', file)—— 后端需启用「同名多值」解析(Express 用upload.array('files'),PHP 遍历$_FILES['files']['name']数组) - ❌ 错误:只
append一次,或把整个input.files当作一个值塞进去(formData.append('files', input.files)),行为不一致,Firefox 直接丢 - 别手动设置
Content-Type请求头——浏览器会自动设为multipart/form-data并生成正确boundary - 调试必看 Network 面板的
Request Payload,确认每个文件是否作为独立条目出现,而不是合并成一个 blob
iOS 低版本和大文件分块处理是两个最容易被跳过的点:前者没有降级方案,后者不处理就容易卡死或内存溢出。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











