HTML的input file不支持原生上传文件夹,webkitdirectory仅Chromium系有效且需搭配directory和multiple属性;File API无法递归读取子目录,仅能获取一级文件及webkitRelativePath路径提示;安全重建目录结构需前端自定义filename并后端校验防路径遍历。

HTML 本身不能上传本地文件夹——<input type="file"> 默认只支持单文件或多个文件,不支持目录(folder)选择。浏览器出于安全限制,禁止网页直接读取任意本地路径结构。
为什么 <input type="file"> 加了 webkitdirectory 还是没反应?
因为该属性仅在 Chrome、Edge(基于 Chromium)中有效,Firefox 和 Safari 完全不支持;且必须配合 directory 属性(而非仅 webkitdirectory),否则被忽略。
正确写法:
<input type="file" webkitdirectory directory multiple />
-
webkitdirectory和directory要同时存在,缺一不可 - 必须加
multiple,否则即使选中文件夹也只提交根目录下的第一个文件 - 用户点击后,浏览器弹出的是「选择文件夹」对话框(不是文件),但仅限于该文件夹内的一级文件——子文件夹里的文件不会递归上传
- 返回的
FileList中每个File对象的webkitRelativePath属性会包含相对路径(如"docs/report.pdf"),这是唯一能还原目录结构的信息
如何用 JavaScript 读取选中的整个文件夹(含子目录)?
不能。原生 File API 不提供递归遍历目录的能力。所谓“上传文件夹”,本质只是上传用户手动选中的那一层文件,webkitRelativePath 是浏览器给的额外提示,不是真正的目录对象。
立即学习“前端免费学习笔记(深入)”;
如果真需要完整目录树(比如打包上传项目源码),可行路径只有两个:
- 前端用
showDirectoryPicker()(需 HTTPS + 用户手势触发),这是现代 File System Access API 的能力,支持递归读取,但兼容性差(Chrome 86+,Edge 86+,Firefox/Safari 仍不支持) - 更稳妥的做法:引导用户先用桌面工具(如 7-Zip、macOS 归档)压缩成
.zip,再用普通<input type="file">上传单个压缩包,后端解压处理
后端怎么解析 webkitRelativePath 重建目录结构?
这个字段只在 Chromium 系浏览器中存在,且内容依赖用户操作路径(例如用户把 /home/user/project/src/main.js 拖进文件夹选择器,实际传过来的可能是 "src/main.js")。它不可靠,不能用于路径拼接或权限校验。
如果你在前端用 FormData 上传,建议显式构造带路径信息的键名:
const formData = new FormData();<br>for (const file of input.files) {<br> const key = file.webkitRelativePath || file.name;<br> formData.append('files', file, key); // 第三个参数设为自定义 filename<br>}
- 后端收到的每个文件的
filename字段就是key值,可据此创建子目录 - 注意过滤掉空路径或上级路径(如
"../etc/passwd"),防止路径遍历漏洞 - Node.js(Express + multer)、Python(Flask +
request.files)、PHP($_FILES)都能拿到这个自定义filename,但需确认中间件是否透传
真正麻烦的从来不是“怎么点一下上传文件夹”,而是“怎么让服务端安全、一致地还原用户本意”。webkitRelativePath 是个便利但脆弱的线索,别把它当契约。



















