webkitdirectory 属性支持原生文件夹选择,需同时设置 directory、multiple 和 webkitdirectory;file.webkitRelativePath 提供相对路径但需服务端严格校验与净化,上传须分组并发且大文件应切片。

用 webkitdirectory 属性触发文件夹选择,但别指望它“开箱即用”
HTML 原生支持文件夹上传,靠的是 input[type="file"] 的 webkitdirectory 属性——不是 JavaScript API,也不是新标准,而是浏览器对已有能力的扩展实现。它能让你一次性选中整个目录,并在 event.target.files 中拿到所有子文件(含嵌套路径),但前提是用户必须主动点选“文件夹”,不能拖拽或通过其他方式绕过。
常见错误现象:
- 加了
webkitdirectory却只能选单个文件 → 检查是否漏了directory和multiple(三者需同时存在) - Firefox/Edge 下不生效 → 实际已支持(Firefox 76+、Edge 90+),但控制台可能报“unknown attribute”,忽略即可,功能照常
- 选中后
file.webkitRelativePath是空字符串 → 用户没选文件夹,而是点了文件夹里的某个文件(浏览器行为:只在真正以“文件夹”为单位选择时才填充该字段)
file.webkitRelativePath 是关键,但不能直接当服务端路径用
每个 File 对象上的 webkitRelativePath 字段,保存的是从所选文件夹根开始的相对路径(如 "图纸/装配图.dwg")。这是前端重建目录结构的唯一依据,但要注意:
- 它只是字符串,不含盘符、主机信息,也**不校验是否存在或合法**;服务端收到后必须做路径净化(如过滤
"../"、拒绝以"."开头的路径) - 不同浏览器对斜杠处理一致(统一为
/),但 Windows 用户本地路径是\,无需前端转换 - 如果文件夹里有同名文件(比如两个
readme.txt在不同子目录),仅靠文件名无法区分——必须依赖webkitRelativePath完整路径做唯一标识
上传时不能走传统 FormData.append("file", file) 简单提交
把几百个文件塞进一个 FormData 并一次性发出去,会吃光内存、触发浏览器限制、让服务端解析超时。真实场景下必须分治:
- 按路径层级或文件大小分组(比如每 20 个文件为一组),避免单次请求体过大
- 对每个
File单独构造FormData,附带path字段(值为file.webkitRelativePath),再用fetch并发上传(建议限流 3–5 路并发) - 不要在前端拼接完整路径作为
filename传给后端——filename只应是叶子文件名(如"齿轮箱.dwg"),路径信息走独立字段更安全 - 大文件(>10MB)建议额外切片,否则单个
fetch请求失败就得重传整个文件
服务端接收路径信息时,webkitRelativePath 必须白名单校验
前端传来的 webkitRelativePath 是不可信输入。哪怕你信任自己的前端代码,中间代理、调试工具、恶意请求都可能伪造它。服务端必须:
- 用正则严格匹配:只允许字母、数字、
-_./,且不能以/或../开头 - 拆解路径后逐级检查深度(如限制最多 5 层嵌套),防止深度遍历耗尽资源
- 拼接存储路径时,用系统安全的路径拼接函数(如 Python 的
os.path.join+os.path.normpath),再验证是否仍在目标根目录内 - 别忽略空路径或纯点号路径(如
"././config.json"),这些是常见绕过点
最易被忽略的一点:很多人以为只要前端用了 webkitdirectory,服务端就能“自动还原文件夹结构”。其实不是——结构还原完全依赖你如何解析和存储这个字符串。少一次 path.split("/").filter(Boolean),就可能把 "//图纸//总装图.dwg" 存成服务器根下的 /图纸/总装图.dwg。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











