webkitdirectory 是 Chromium 系列浏览器原生支持上传整个文件夹的唯一方式,但 Firefox 和 Safari 不支持;需手动提取 file.lastModified 等元数据并随 FormData 发送,服务端须调用系统 API 还原时间戳;ZIP 封装更兼容、可靠。

HTML 上传文件夹必须用 webkitdirectory,但仅限 Chromium 系列
浏览器原生支持上传整个文件夹的唯一方式是给 加上 webkitdirectory 属性。它不是标准属性,而是 Chrome、Edge(基于 Chromium)、新版 Opera 的私有扩展。Firefox 和 Safari 完全不支持,IE 更不用提。
常见错误现象:在 Firefox 中加了 webkitdirectory 却没反应,或误以为 multiple 能选中整个文件夹——其实它只允许多选文件,不能穿透目录结构。
-
是推荐写法(directory是 HTML5 标准属性,但目前仅作语义提示,实际依赖webkitdirectory) - 用户点击后,浏览器会弹出文件夹选择对话框(非文件选择),选中后
event.target.files返回的是一个FileList,其中每个File对象都带完整路径(如"docs/report.pdf"),可用于还原层级 - 注意:该
FileList不包含空子目录,只含实际文件;且路径是相对文件夹根的,不是绝对路径
File.lastModified 可读取修改时间,但无法靠表单自动提交
HTML 表单本身不会把文件元数据(如修改时间、创建时间)作为字段发出去。即使你用了 webkitdirectory,FormData.append() 传的仍是原始二进制内容,lastModified 这类属性不会随文件一起走。
所以必须手动提取并附带传输:
- 遍历
event.target.files,对每个File对象读取file.lastModified(毫秒时间戳)和file.name(含相对路径) - 构造一个元数据数组,例如:
[{name: "a/b.txt", lastModified: 1730646480000}] - 用
FormData.append("metadata", JSON.stringify(metadata))一并发送 - 服务端需解析这个字段,并在保存文件时用对应时间戳设置文件系统修改时间(如 Node.js 的
fs.utimes,PHP 的touch)
服务端还原 lastModified 需要操作系统级权限和显式调用
上传后,文件在服务器上默认以接收时刻为修改时间。想还原客户端的 lastModified,光靠写入文件内容不够,必须额外调用系统 API 设置 mtime。
不同语言示例:
- Node.js:
fs.promises.utimes(filePath, lastModified / 1000, lastModified / 1000)(注意单位是秒) - Python(Flask):
os.utime(file_path, (atime, mtime)),其中mtime = client_timestamp / 1000 - PHP:
touch($filePath, $clientLastModified)(PHPtouch()第二个参数就是 mtime 秒级时间戳)
容易踩的坑:某些容器环境(如 Docker 默认 rootfs)或云存储后端(如对象存储 OSS)不支持修改文件系统时间戳;此时只能将时间存入数据库或文件头注释,无法真正“还原”。
跨平台兼容性差 + 元数据易丢失,建议优先考虑 ZIP 封装
如果目标是可靠保留时间戳+目录结构+多浏览器支持,webkitdirectory 方案实际落地风险高。更稳健的做法是:前端用 JSZip 或类似库把整个文件夹打包成 ZIP,再上传单个 ZIP 文件。
优势明显:
- ZIP 格式自带文件修改时间字段,解压工具和服务端库(如 Python
zipfile、Node.jsadm-zip)能直接读取并还原 - 一次上传解决所有问题,不依赖浏览器私有属性
- 服务端解压时可自然重建目录结构,同时批量设置各文件时间戳
代价是前端需压缩(可能卡 UI)、用户感知多一步“打包”,但比调试 webkitdirectory 在不同 Chrome 版本下的行为稳定得多。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











