如何在Node.js中使用JSZip按数组顺序添加文件到Zip包

JSZip默认会根据文件的最后修改日期对压缩包内的文件排序，这就导致你按数组顺序添加的文件最终在压缩包里是反转的。要保持数组的原始添加顺序，只需要在生成压缩包时配置fileSort选项即可。

核心解决方案 #

在调用generateAsync方法时，将fileSort设置为null，这样JSZip就会保留你添加文件的顺序，而不会进行默认的日期排序。

代码示例 #

const zip = new JSZip();

// 你的目标文件数组，按期望顺序排列
const targetFiles = [
  { name: "first-file.txt", content: "这是数组第一个文件的内容" },
  { name: "second-file.txt", content: "这是数组第二个文件的内容" },
  { name: "third-file.txt", content: "这是数组第三个文件的内容" }
];

// 按数组原顺序逐个添加文件
targetFiles.forEach(file => {
  zip.file(file.name, file.content);
});

// 生成压缩包时禁用默认排序
zip.generateAsync({
  type: "blob",
  fileSort: null // 关键配置：取消默认日期排序
}).then(blob => {
  // 示例：触发下载
  const downloadLink = document.createElement("a");
  downloadLink.href = URL.createObjectURL(blob);
  downloadLink.download = "ordered-files.zip";
  downloadLink.click();
  URL.revokeObjectURL(downloadLink.href);
});

自定义排序（可选） #

如果需要更精细的排序控制，也可以传入自定义的排序函数。比如要严格保持添加顺序，也可以这样写：

zip.generateAsync({
  type: "blob",
  fileSort: (a, b) => 0 // 不调整任何顺序
});

原理说明：JSZip默认的fileSort逻辑会对比文件的date属性来排序，设置为null后，它会直接使用文件被添加到zip实例中的顺序，也就是你遍历数组时的顺序。

内容的提问来源于stack exchange，提问作者Mustafa Aswadi