HTML原生不支持文件夹上传,需用非标准webkitdirectory属性;仅Chrome、Edge(Chromium)、Safari(16.4+)支持,Firefox完全不支持;选中文件夹后递归列出所有子文件(不含子文件夹),File对象含webkitRelativePath可还原层级,但非标准且Firefox中为空。

HTML原生不支持文件夹上传,input[type="file"] 默认只传文件
浏览器对 input[type="file"] 的文件夹支持依赖于 webkitdirectory 非标准属性,且仅在 Chrome、Edge(Chromium 内核)和 Safari(16.4+)中可用。Firefox 完全不支持,且该属性无法触发传统“选择文件夹”对话框——它实际是让用户选择一个文件夹后,递归列出其**所有子文件(不含子文件夹本身)**。
常见错误现象:event.target.files 为空或只返回根目录下几个文件,但深层嵌套的文件没出现;或者开发者误以为能拿到文件夹路径,其实 File 对象里只有 name(含相对路径)、size、lastModified,没有真实路径字段。
- 必须显式添加
webkitdirectory属性(注意前缀),directory单独写无效 -
multiple属性可选,但加上更稳妥(部分旧版 Chrome 要求同时存在) - 不能用
accept过滤文件夹类型——它只对文件扩展名生效,对目录无意义 - 用户看到的仍是“选择文件夹”提示,但底层行为是“展开并提交该目录下所有文件”
如何用 webkitdirectory 正确获取文件列表并保留层级信息
webkitdirectory 模式下,每个 File 对象的 webkitRelativePath 属性会返回从所选文件夹开始的相对路径(如 "src/js/main.js"),这是唯一能还原目录结构的依据。但该属性非标准,Firefox 中为 "",需降级处理。
实操建议:
- 检查
event.target.files是否有内容,再遍历:const files = event.target.files; for (let i = 0; i
- 不要依赖
file.path或file.fullPath—— 它们在现代浏览器中已被移除或始终为空 - 若需构建树形结构,按
/分割webkitRelativePath,逐级生成路径前缀,再用 Map 或对象聚合 - 注意性能:万级小文件会导致
FileList构建慢、内存占用高,建议加 loading 提示并限制最大文件数(前端校验)
后端接收时如何解析多层路径并保存到对应目录
前端传来的只是扁平化的 File 列表,每个文件附带 webkitRelativePath。后端需自行按路径拆分、创建子目录、写入文件。关键点不在 HTML,而在服务端如何安全还原结构。
使用场景与风险:
- Node.js(Express +
multer):默认multer不解析路径,需自定义storage.destination函数,从req.file.originalname提取相对路径并fs.mkdirSync(..., { recursive: true }) - Python(Flask):
request.files.getlist("file")获取全部,遍历每个file.filename(即webkitRelativePath),用os.path.dirname()提取父目录并os.makedirs() - ⚠️ 严重安全风险:绝对禁止直接拼接
webkitRelativePath到服务器路径(如/uploads/ + file.filename),攻击者可构造../../../etc/passwd绕过。必须先标准化路径:path.resolve(uploadDir, path.normalize(file.webkitRelativePath)),再校验是否仍在uploadDir下 - PHP(
$_FILES):同理,$_FILES['file']['name']是相对路径,需用realpath()和dirname()做白名单校验
替代方案:为什么多数生产项目不用 webkitdirectory
真正需要完整文件夹上传的业务(如静态网站部署、设计稿批量提交),几乎都弃用原生方案,改用基于 WebkitDirectory 的封装库或桌面客户端桥接,因为兼容性、安全性、体验三者不可兼得。
更可行的做法:
- 用
dropzone.js或uppy.io—— 它们内部检测webkitdirectory支持,并 fallback 到 ZIP 上传(用户手动压缩文件夹,前端解压再上传) - Electron / Tauri 桌面应用:直接调用系统 API 读取目录树,无浏览器限制
- WebDAV 协议:后端启用 WebDAV,前端用
webdav-client库递归 PUT,但需服务端额外配置 - 最简单兜底:明确提示“请将文件夹压缩为 ZIP 后上传”,用
JSZip在前端解压并提取路径,可控性更高
容易被忽略的一点:即使浏览器支持 webkitdirectory,用户也可能禁用 JavaScript、用旧版浏览器、或在 iOS Safari 上完全不可用——任何依赖它的功能都必须有明确的降级文案和操作指引。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











