HTML原生不支持多文件夹选择,仅单文件夹可行:需同时设置webkitdirectory和directory属性,并添加multiple;拖放API是实现多文件夹上传的唯一方案,需递归遍历目录并校验路径安全性。

HTML 原生不支持直接用 <input type="file"> 选多个文件夹,但单个文件夹上传是可行的——关键在属性组合和浏览器兼容性处理。
单文件夹上传:webkitdirectory 和 directory 必须同时写
只写 webkitdirectory,Firefox 不认;只写 directory,Chrome/Edge 会忽略。必须两个都加,才能覆盖主流桌面浏览器。
-
<input type="file" webkitdirectory directory multiple>——multiple不是可有可无,它让 Chrome 能正确读取子目录里的所有文件(否则只返回根目录下的文件) - 选中后,每个
File对象的webkitRelativePath属性包含完整路径(如"docs/spec.pdf"),这是还原目录结构的唯一依据 - macOS 用户拖入文件夹时可能带
__MACOSX/隐藏目录,需在遍历前过滤:file.webkitRelativePath.split('/').some(seg => seg.startsWith('__MACOSX') || seg.startsWith('.'))
多文件夹上传:只能靠拖放 API,<input> 根本做不到
浏览器原生文件选择对话框强制限制为“单文件夹”,想一次拖入 project_a/、project_b/ 两个根目录?<input> 永远没戏,必须换路子。
- 监听
drop事件,从event.dataTransfer.items中逐项调用item.webkitGetAsEntry() - 判断是否为目录:
entry.isDirectory(注意:不是item.kind === 'file'就能进,得先确认是目录再递归读取) - 递归遍历要用
dirReader.readEntries(),不能用fs.readdirSync——那是 Node.js,浏览器里没有同步文件系统 API - Chrome 最新版本对拖入嵌套过深的目录(>10 层)会静默截断,建议前端加层级深度警告
上传时保留目录结构:后端必须按 webkitRelativePath 解析路径
前端把 file.webkitRelativePath 当普通字段传给后端没用,后端得主动用它拼出存储路径,否则所有文件全挤在根目录下。
立即学习“前端免费学习笔记(深入)”;
- Node.js + multer 示例:别用
upload.single(),改用upload.array('files'),然后循环处理每个req.files[i]的原始originalname(但注意:这个字段不含路径!必须前端额外传relativePath字段) - Python Flask 示例:前端在
FormData.append()时,除了file,还要加FormData.append('path', file.webkitRelativePath);后端用request.form.get('path')拼出os.path.join(UPLOAD_DIR, path) - 绝对别依赖
req.file.path或req.file.filename来还原结构——它们是临时路径或服务端重命名后的名字,跟原始目录无关
常见报错和绕过方法
用户点开选择框却看不到“文件夹”选项?或者选了文件夹但 event.target.files.length === 0?大概率是属性漏了或环境不匹配。
-
Failed to execute 'webkitGetAsEntry' on 'DataTransferItem': The request is not allowed by the user agent or the platform:Safari 完全不支持该 API,连拖放目录都不行;IE 已淘汰;国产信创浏览器(如红莲花)需查具体版本文档,部分仅支持webkitdirectory单文件夹 -
event.target.files为空:检查是否用了click()触发 input,这不会触发 change 事件;必须等用户真实操作后监听change - 上传大文件夹卡死:浏览器一次性读取几百个
File对象会阻塞主线程,建议用setTimeout分批处理,或改用requestIdleCallback防止 UI 冻结
真正麻烦的不是怎么选文件夹,而是后端能不能安全地把 ../../etc/passwd 这种恶意路径解析成合法目录——路径校验和白名单机制,比前端代码更关键。



















