不能。webkitdirectory仅返回所选目录的直接子项(含文件和空目录对象),不包含子目录内部文件;子目录需通过webkitGetAsEntry()转为FileSystemEntry后,调用createReader().readEntries()递归遍历获取。

浏览器原生不支持递归读取文件夹子目录,webkitdirectory 只能获取当前选中目录下的**直接子文件和子文件夹的顶层条目**,不会自动展开嵌套层级。要读取子文件夹里的文件,必须手动遍历并调用 file.webkitGetAsEntry() + entry.createReader().readEntries()。
为什么 event.target.files 里没有子文件?
因为 input[type="file"][webkitdirectory] 返回的 FileList 是扁平化的:它只包含用户所选目录下**第一层所有项**(含文件、子文件夹),但子文件夹本身只是个 File 对象,不带其内部内容。它的 name 是文件夹名,size 是 0,type 是空字符串——它不是“不可读”,而是“没被解析为目录结构”。
-
File对象本身不提供递归能力,仅描述元数据 - 真正能访问层级结构的是
FileSystemEntry(通过webkitGetAsEntry()转换) - Chrome/Edge 支持该 API;Firefox 使用
mozdirectory但不支持webkitGetAsEntry,需降级处理
怎么把文件夹转成可遍历的 FileSystemEntry?
对每个 File 调用 .webkitGetAsEntry(),判断它是 file 还是 directory 类型,再分别处理:
- 如果是
isFile === true,直接用FileReader读取内容或记录路径 - 如果是
isDirectory === true,调用entry.createReader().readEntries()获取其子项列表 - 注意:
readEntries()是异步且**分页返回**的,可能需要循环调用直到结果为空数组
function readEntry(entry, path = '') {
if (entry.isFile) {
entry.file(file => {
console.log('文件:', path + file.name);
// 这里可 push 到 files[] 或触发 FileReader
});
} else if (entry.isDirectory) {
const reader = entry.createReader();
reader.readEntries(entries => {
entries.forEach(subEntry => {
readEntry(subEntry, path + entry.name + '/');
});
});
}
}
实际使用时容易踩的坑
这些不是边缘情况,而是上线后高频报错点:
立即学习“前端免费学习笔记(深入)”;
-
webkitGetAsEntry()在 Firefox 中返回null,必须先检测存在性:if (!file.webkitGetAsEntry) return; - 用户选中的是根目录(如
C:\或/),部分浏览器会拒绝访问,抛出SecurityError -
readEntries()不保证一次性返回全部子项,尤其在大量文件时,需用递归+回调链处理,不能简单 for 循环 - 没有错误兜底:比如子目录权限不足、路径含非法字符,
readEntries()的 error 回调会被静默吞掉,需监听reader.onerror - 无法获取绝对路径,所有路径都是相对用户选择目录的,
file.fullPath仅在沙箱内有效,不能用于<img src alt="HTML上传文件夹怎么读取子文件?实现步骤解析" >或fetch()
真正的难点不在“怎么写”,而在“怎么让不同浏览器都稳定返回完整树形结构”。建议优先用 input[webkitdirectory] + 扁平化展示一级内容;若必须深度遍历,就接受 Chrome/Edge 为首选目标,Firefox 用户降级为仅读取第一层,并明确提示限制。



















