从网站下载ZIP压缩包，解压后文件全部散落在当前目录，或者目录结构整个错位——很多人遇到这种情况时，第一反应是压缩软件出了问题。但真正的原因，往往藏在压缩包内部每个文件条目名称的路径分隔符里。ZIP规范中，条目名习惯使用正斜杠表示目录层级，而不同系统、不同压缩工具、不同解压库对这个字符的处理方式并不一致，一旦写入或解析环节出现偏差，目录结构就会在解压时被打散。
第一层：核对压缩端写入条目名时用的是哪种分隔符
在Windows环境下打包时，部分工具会把路径写成反斜杠，另一些工具则统一转成正斜杠。如果同一个包里两种写法混用，解压程序就可能只识别其中一种，把另一种当作文件名的一部分，于是出现“文件夹名加反斜杠加文件名”这样的怪异条目。检查方法是打开压缩包查看条目列表，观察目录层级是用正斜杠还是反斜杠表达，是否存在混用。规范做法是写入时统一使用正斜杠，避免依赖解压端猜测。
第二层：核对服务端解压库对条目名的规范化处理
有些解压库会把反斜杠原样保留为普通字符，不做转换，结果在目标系统上生成一个名字里带反斜杠的文件，而不是进入子目录。另一些库则会主动把反斜杠转成正斜杠。同一份压缩包在不同库下表现可能完全不同。排查时应确认所用解压库的版本和文档说明，看它是否对条目名做路径规范化，以及规范化的具体规则。这一步不能靠猜，要以库的官方说明为准。
第三层：核对目标文件系统对保留字符和目录层级的限制
条目名里如果出现绝对路径、上跳目录或超长层级，解压时可能被拒绝、被截断，或者写到预期之外的目录。更隐蔽的风险是同名覆盖：两个条目规范化后指向同一路径，后解压的文件会覆盖先前的文件，用户看到的只是“少了一个文件”。因此要检查条目名中是否含绝对路径前缀、是否含上跳片段、层级深度是否合理。
压缩包条目名检查清单
一是统一使用正斜杠作为分隔符，打包前批量检查；二是拒绝以斜杠开头的绝对路径条目；三是过滤含上跳目录的条目，防止写出目标目录；四是限制目录层级深度，避免异常嵌套；五是对规范化后的路径做去重检查，防止同名覆盖。
修复后不要直接全量上线，先用小样本回归验证：准备一个包含多级目录、中文名、特殊字符的测试包，分别在目标解压库和目标文件系统上解压，逐条比对条目名与落盘路径是否一致。确认无误后再处理真实用户上传。涉及具体解压库的行为差异，应以官方文档和实际测试结果为准，不宜凭经验下结论。it数运在处理此类上传与解压链路问题时，通常也是按压缩端、解压端、文件系统三层逐项核对，把问题定位到具体环节再动手修改。
