HTML无法直接上传文件夹,但可通过触发浏览器原生文件夹选择,利用file.webkitRelativePath还原目录结构,Chrome/Edge/Firefox支持,Safari及移动端不支持。

不行,HTML本身不能“直接”上传文件夹——但现代浏览器支持通过 webkitdirectory 和 directory 属性让 <input type="file"> 选择整个文件夹,并递归暴露其内部所有文件(含相对路径),这才是实际可行的起点。
为什么 webkitdirectory 是关键入口
它不是 HTML 标准属性,而是 Chrome/Edge 等基于 WebKit/Blink 内核浏览器的扩展能力。Firefox 则用 directory 实现等效行为。两者必须配合 multiple 才能生效:
-
<input type="file" webkitdirectory directory multiple>是目前唯一能触发文件夹选择对话框的合法方式 - 不加
multiple时,Chrome 会静默忽略webkitdirectory,选中后e.target.files.length === 0 - IE 和旧版 Edge(非 Chromium)完全不支持,
if ('webkitdirectory' in document.createElement('input'))可做基础检测 - macOS Finder 选中文件夹时,会额外生成
__MACOSX/隐藏目录,需在 JS 中过滤,否则可能触发后端校验失败
file.webkitRelativePath 决定你能否还原目录结构
这是整个方案能否落地的核心字段。它返回的是文件在原始文件夹中的完整路径(如 "src/js/main.js" 或 "assets/images/logo.png"),而非操作系统绝对路径。没有它,就只剩一堆同名文件,无法区分层级。
- 该字段仅在使用
webkitdirectory或directory选择文件夹时存在;手动多选文件不会生成 - Firefox 返回的
webkitRelativePath是空字符串,但会提供relativePath(标准草案字段,尚未全平台统一) - 服务端需按此路径创建子目录或拼接存档名,例如:将
file.webkitRelativePath作为FormData.append()的filename参数值 - 注意路径分隔符:Windows 用户选中文件夹时,
webkitRelativePath仍用/,不是\,无需转义
FormData 提交时容易漏掉的三个细节
即使拿到了带路径的 File 对象,直接 fd.append('file', file) 会丢失路径信息——后端收到的只是文件内容,不知道它原本在哪一层级。必须显式传递路径上下文。
立即学习“前端免费学习笔记(深入)”;
- 不要只传
file,而要传file+ 路径标识:fd.append('file', file, file.webkitRelativePath || file.name) - 如果后端需要统一前缀(如
"project-v1/"),可在前端拼接:fd.append('file', file, 'project-v1/' + file.webkitRelativePath) - 单次提交大量文件(如 200+)时,避免一次性构造超大
FormData,可分批上传并携带folder_id或session_token让后端聚合 - 别忘了设置
enctype="multipart/form-data"—— 表单提交时若漏掉,浏览器会把文件当普通字符串发过去,后端收不到二进制流
兼容性与 fallback 的真实代价
所谓“兼容 IE9”或“全浏览器支持文件夹上传”,本质上是伪需求。真正要做的,是明确告知用户哪些浏览器支持,并为不支持者提供降级路径。
- Chrome ≥ 19、Edge ≥ 79、Firefox ≥ 50 支持,Safari 始终不支持(截至 2026 年 11 月)
- 降级方案只能是“手动多选文件”,无法保持结构;若业务强依赖目录树(如 CAD 工程包),必须前端 zip 打包(用
JSZip)再上传单个 zip,但会显著增加内存占用和首屏等待时间 - 移动端(iOS Safari / Android WebView)基本不支持
webkitdirectory,需单独判断navigator.userAgent并隐藏该功能入口 - 最常被忽略的一点:用户右键“在文件管理器中打开”再拖入网页,不会触发
webkitRelativePath,只有通过<input>原生弹窗选择才有效



















