如何阻止Safari自动解压ZIP文件？避免仅提取首个文件的问题

针对Safari自动解压ZIP文件（甚至出现仅解压首个成员、丢失其余内容的问题），无需访客手动修改浏览器设置的解决方案如下：

一、服务器端HTTP头配置（推荐方案） #

这是最稳定的解决方式，通过修改响应头强制浏览器以附件形式保存ZIP：

• 设置Content-Disposition头：明确标记为附件并指定带.zip后缀的文件名，Safari会直接触发下载而非自动解压。示例响应头：

  Content-Disposition: attachment; filename="your-archive.zip"
  

• 配合Content-Type头加固：将默认的application/zip改为通用二进制流类型application/octet-stream，进一步避免Safari识别并解析ZIP结构：

  Content-Type: application/octet-stream
  

  注：Content-Disposition优先级更高，两者搭配使用效果最优。

二、修改ZIP文件结构（无服务器配置权限时使用） #

如果无法调整服务器设置，可通过修改ZIP本身的结构规避自动解压：

• 在ZIP的最开头添加一个空目录作为第一个条目。Safari的自动解压逻辑对以目录开头的ZIP包不会触发自动提取，且这个空目录不会影响其他解压工具正常处理文件。
• 避免将单个文件作为ZIP的首个条目：这正是触发Safari自动解压并导致PR#42中部分文件丢失的核心场景，调整条目顺序即可规避。

三、针对stream-zip流式ZIP生成的特殊处理 #

结合你提到的stream-zip项目PR#42问题，流式生成ZIP时需额外注意：

• 在流式响应输出前就设置好上述HTTP头，不要在流传输过程中补设；
• 流式生成ZIP时优先写入空目录条目，再写入实际文件内容，从根源上阻止Safari触发自动解压逻辑。

内容的提问来源于stack exchange，提问作者Michal Charemza