JavaScript 如何压缩目录并上传？

发布时间：2025-11-04 19:12:32 来源：码上建站 作者：系统运维

本文转载自微信公众号「全栈修仙之路」，何压作者阿宝哥。缩目上传转载本文请联系全栈修仙之路公众号。录并

在日常工作中，何压文件上传是缩目上传一个很常见的功能。在上传文件时，录并我们可以选择上传单个文件，何压也可以通过设置 multiple 属性来上传多个文件。缩目上传

本文阿宝哥将介绍如何上传目录及如何压缩目录并上传，录并压缩目录的何压功能是通过 JSZip 这个库来实现。利用这个库还可以实现在线预览 ZIP 文件的缩目上传功能，感兴趣的录并小伙伴可以阅读 JavaScript 如何在线解压 ZIP 文件? 这篇文章。下面我们先来介绍如何实现压缩目录并上传的何压功能。

一、缩目上传浏览器端

1.1 选择目录

在浏览器端，录并要实现压缩目录并上传的功能。首先我们要先实现选择目录的功能，要实现该功能，我们可以直接使用 HTMLInputElement 元素的 webkitdirectory 属性：

当设置了 webkitdirectory 属性之后，我们就可以选择目录了。当阿宝哥选择了 useAxios 目录之后，就会显示以下确认框：

点击上传按钮之后，我们就可以获取文件列表。列表中的免费源码下载文件对象上含有一个 webkitRelativePath 属性，用于表示当前文件的相对路径。在进行目录压缩的时候，我们就会使用到该属性。

虽然通过 webkitdirectory 属性可以很容易地实现选择目录的功能，但在实际项目中我们还需要考虑它的兼容性。比如在 IE 11 以下的版本就不支持该属性，其它浏览器的兼容性如下图所示：

(图片来源 —— https://caniuse.com/?search=webkitdirectory)

1.2 压缩目录

在 JavaScript 如何在线解压 ZIP 文件? 这篇文章中，阿宝哥介绍了在浏览器端如何使用 JSZip 这个库实现在线解压 ZIP 文件的功能。JSZip 这个库除了可以解析 ZIP 文件之外，它还可以用来创建和编辑 ZIP 文件。这里阿宝哥基于 JSZip 库提供的 API，封装了一个 generateZipFile 函数：

在以上代码中，我们使用 file(name, data [,options]) 方法，把目录中的文件依次添加到 zip 对象中，然后再通过 generateAsync 方法来生成 ZIP 文件。在生成 ZIP 文件时，我们可以设置该文件的类型。这里我们设置的默认类型为 blob 类型，除了支持 blob 类型之外，它还支持 base64、免费信息发布网uint8array 和 arraybuffer 等类型。

1.3 上传压缩 ZIP 文件

在压缩目录生成 ZIP 文件之后，我们就可以通过 XMLHttpRequest 或 fetch API 来上传压缩文件。下面阿宝哥将以 axios 为例，来实现文件上传的功能。

html 代码

js 代码

在 uploadFile 函数中，如果有启用目录压缩功能，我们就会调用 generateZipFile 函数生成 ZIP 文件，如果没有的话，就会直接调用 uploadFiles 函数来上传目录中的所有文件，当然你也可以对文件列表进行过滤，比如限制文件类型或文件的大小等。

下面我们来看一下 uploadFiles 函数的具体实现：

在 uploadFiles 函数中，我们通过创建 FormData 对象来保存文件的信息，然后通过 request(axios 实例)来执行上传操作。

二、服务器端

2.1 接收 ZIP 文件

在服务端要实现文件上传功能也比较简单，这里阿宝哥以 koa 为例来实现文件上传的功能。如果你对 koa 还不了解的话，建议你先大致浏览一下 koa 的官方文档。

在以上代码中，我们通过 @koa/multer 这个中间件来处理文件上传，对该中间件感兴趣的源码下载小伙伴，可以自行阅读官方文档。接下来，我们来继续讨论另一个问题 —— 如何接收目录并按照文件目录结构进行存放?

2.2 接收文件目录

前面我们已经知道，当 input[type="file"] 使用了 webkitdirectory 属性之后，返回 File 对象的 webkitRelativePath 属性就会存放当前文件相对于当前目录的相对路径：

因此当我们在服务端处理文件目录上传的功能时，我们就可以通过该属性来创建对应的目录结构，具体的处理逻辑如下所示：

为什么 originalname 文件原始名称会包含 @ 符号呢?这样因为使用 useAxios/demo.vue 这种路径形式时，是不能获取到完整的路径名称，只能获取到文件名。为了解决这个问题，阿宝哥在上传文件时，手动把文件相对路径中的 / 符号替换为 @ 然后再进行上传，对应的处理逻辑如下：

好的，压缩目录上传和目录上传已经介绍完了，感兴趣的小伙伴可以动手试试看。由于完整的示例代码内容比较多，阿宝哥就不放具体的代码了。有需要的小伙伴，可以访问以下地址浏览示例代码。

https://gist.github.com/semlinker/af57349c16d203cc2ec845d4b5a6b445

注意：以上代码仅供参考，请根据实际业务进行调整。

三、总结

本文阿宝哥介绍了如何利用 input[type="file"] 元素的 webkitdirectory 属性来实现选择目录的功能，然后利用 JSZip 这个库来实现目录压缩，最后通过 axios 来上传目录压缩后的 ZIP 文件 。此外，阿宝哥还介绍了如何使用 koa 来实现接收目录并按照文件目录结构进行存放的功能。

四、参考资源

JSZip 官方文档

MDN - webkitdirectory

JavaScript 如何在线解压 ZIP 文件?

相关文章