浏览器原生拖拽文件夹时,e.dataTransfer.files 为空,因文件夹非文件而是 directory 类型 DataTransferItem,须用 e.dataTransfer.items 配合 webkitGetAsEntry()(Chromium)或 getAsFileSystemHandle()(Firefox)递归遍历获取带路径的 File 对象。

浏览器原生支持文件夹拖拽上传,但只靠 e.dataTransfer.files 拿不到子目录结构——必须用 e.dataTransfer.items 配合 webkitGetAsEntry() 递归遍历,否则上传的只是顶层文件,目录层级全丢。
为什么 e.dataTransfer.files 不能用于文件夹
拖拽文件夹时,e.dataTransfer.files 是空的或只含零个文件(Chrome/Firefox 行为一致),真正入口在 items。这是因为文件夹不是“文件”,而是 DataTransferItem 类型为 directory 的条目。
-
e.dataTransfer.files.length === 0是正常现象,别误判为用户没拖对 -
e.dataTransfer.items才包含真实目录项,需逐项调用item.webkitGetAsEntry() - Firefox 不支持
webkitGetAsEntry,要用item.getAsFileSystemHandle()(仅 Chromium/Edge 117+ 支持) - IE 和旧版 Safari 完全不支持拖拽文件夹,得降级为
<input type="file" webkitdirectory>
如何递归提取文件夹内所有文件并保留路径
核心是用 DirectoryEntry + createReader().readEntries() 做 DFS 遍历,每个 FileEntry 的 file() 方法才真正生成可上传的 File 对象,并通过 fullPath 或 webkitRelativePath 记录层级。
htmlq 是一个命令行工具,使用 CSS 选择器从 HTML 中提取内容,相当于 jq 的 HTML 版本。该工具使用 Rust 编写,允许你通过 CSS 选择器将 HTML 管道化,直接从终端提取文本、属性和结构化内容。
- 入口判断:对每个
item调用item.webkitGetAsEntry(),返回null则跳过 - 目录处理:若
entry.isDirectory为true,用entry.createReader().readEntries()获取子项 - 文件处理:若
entry.isFile,调用entry.file(callback),回调中拿到带webkitRelativePath的File - 路径拼接:
entry.fullPath是以/开头的绝对路径(如/project/img/logo.png),上传前需截掉首斜杠
上传时怎么把路径信息传给后端
FormData 本身不支持嵌套字段,路径必须作为额外字段显式附加,否则后端无法重建目录结构。
立即学习“前端免费学习笔记(深入)”;
- 每个文件单独 append 到 FormData:
formData.append('files', file) - 同时 append 同名路径字段:
formData.append('paths', file.webkitRelativePath)(顺序严格对应) - 或合并为 JSON 字段:
formData.append('fileData', JSON.stringify({ path: file.webkitRelativePath, size: file.size })) - 服务端必须按顺序读取
files和paths字段,不能依赖 key 名匹配——因为 multipart 解析顺序不保证稳定
容易被忽略的边界问题
实际部署时最常崩在内存和权限上,不是逻辑写错,而是没预判浏览器行为。
- 大文件夹(>1000 个文件)递归调用
readEntries()可能触发堆栈溢出,建议加setTimeout分批处理 -
webkitRelativePath在某些 macOS 版本下会返回空字符串,fallback 方案是用entry.fullPath并手动 normalize - 用户拖拽的是符号链接或挂载卷(如 /Volumes/MyDisk),
webkitGetAsEntry()可能拒绝访问,需捕获NotFoundError异常 - 移动端 Safari 完全禁用文件夹拖拽,且不支持
webkitdirectory,iOS 用户只能单文件上传


















