原生HTML不支持多文件夹上传,仅webkitdirectory可选单文件夹;可行方案是拖放API配合webkitGetAsEntry()递归遍历,但仅限桌面Chrome/Edge/Safari,且需后端严格校验路径防穿越。

不支持原生多文件夹上传。HTML 标准的 只能通过 webkitdirectory 选一个文件夹,加 multiple 也没用——浏览器会忽略或报错。
为什么 webkitdirectory + multiple 不能选多个文件夹
这是常见误解的源头。实际行为是:
-
webkitdirectory和multiple同时存在时,Chrome/Edge 会禁用多选能力,只允许选一个文件夹;Safari 表现不一致,部分版本直接不响应 -
directory属性(Firefox 曾短暂支持)已废弃,当前 Firefox 完全不识别webkitdirectory,webkitRelativePath始终为空 - 即使能触发,
event.target.files返回的仍是扁平化的FileList,没有“哪个文件属于哪个文件夹”的元信息,无法反推来源文件夹边界
真正可行的多文件夹方案:拖放 API + webkitGetAsEntry()
必须绕过 ,用拖放区域接收用户拖入的多个文件夹。核心是处理 dataTransfer.items:
- 每个
item调用item.webkitGetAsEntry(),再判断entry.isDirectory - 对每个文件夹调用
entry.createReader().readEntries()递归遍历,手动拼接相对路径(entry.fullPath是绝对路径,需裁剪根目录) - 注意:该 API 仅限桌面 Chrome/Edge/Safari,移动端和 Firefox 不可用
- 示例关键逻辑:
for (const item of event.dataTransfer.items) { if (item.kind === 'file') { const entry = item.webkitGetAsEntry(); if (entry && entry.isDirectory) { traverseDirectory(entry, entry.name); // 自定义递归函数 } } }
后端必须按路径重建结构,且校验安全性
前端传过去的只是带路径的 File 对象(如 formData.append('file', file, 'project/src/index.js')),后端不能直接信任:
-
webkitRelativePath可被伪造(比如用户改名后拖入),必须校验路径是否合法:禁止../、空路径、超长路径、非法字符 - 服务端收到后要解析路径字段,逐级创建目录,再写入文件——不能简单用原始文件名存到同一级
- 大文件夹(如含上万个文件)别一次性读取全部内容进内存,应流式处理或分批提交
- 如果业务真需要跨浏览器支持,就得放弃原生方案,改用桌面客户端(Electron/Tauri)或 WebAssembly 文件系统桥接
最易被忽略的一点:所谓“多文件夹上传”,本质不是传输容器,而是传输一组带层级关系的文件。路径信息必须由前端生成、后端严格验证并执行,中间任何一环缺失都会导致结构丢失或路径穿越漏洞。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











