Java原生zip包因未强制编码规范致中文文件名乱码，推荐用Apache Commons Compress显式设UTF-8编码并启用ZIP UTF-8 flag，确保跨平台兼容；替代方案为Apache Ant的Zip工具；JVM参数及原生API均不可靠。
Java 原生 java.util.zip 包在压缩含中文文件名的 ZIP 时，默认用系统平台编码（如 Windows 是 GBK）处理文件名，而现代解压工具（如 7-Zip、macOS 归档）默认按 UTF-8 解析，导致乱码。这不是“写错了”，而是 ZIP 规范未强制编码 + JDK 实现未暴露编码控制权所致。解决关键在于：**压缩时主动用 UTF-8 编码写入文件名，并确保解压端能正确识别**。
推荐方案：用 Apache Commons Compress（最稳）
它支持显式指定编码，兼容 ZIP 规范中的 UTF-8 flag（第11位），跨平台表现一致。
- 添加 Maven 依赖：
- 压缩时指定 UTF-8：
try (ArchiveOutputStream aos = new ZipArchiveOutputStream(
new FileOutputStream("output.zip"))) {
aos.setEncoding("UTF-8"); // 关键：强制使用 UTF-8 写文件名
ZipArchiveEntry entry = new ZipArchiveEntry("中文目录/测试文档.pdf");
aos.putArchiveEntry(entry);
// 写入文件内容...
aos.closeArchiveEntry();
}
- 生成的 ZIP 在 WinRAR、7-Zip、macOS 下均可正常显示中文名，且 Java 端用同库解压也不会乱码。
替代方案：用 Apache Ant 的 Zip 工具（轻量兼容）
Ant 的 org.apache.tools.zip.* 类提供了 setEncoding() 方法，比原生 API 更早支持编码控制，适合不想引入较重依赖的项目。
- Maven 依赖：
- 代码示例：
try (ZipOutputStream zos = new ZipOutputStream(new FileOutputStream("out.zip"))) {
zos.setEncoding("UTF-8"); // 显式设为 UTF-8
ZipEntry entry = new ZipEntry("简历_张三.docx");
zos.putNextEntry(entry);
// 写入字节流...
zos.closeEntry();
}
不依赖第三方？可尝试 JVM 启动参数（仅限部分场景）
Java 7+ 起可通过系统属性 sun.zip.encoding 影响 ZipInputStream 行为，但对 ZipOutputStream 无效，且该属性非标准、不可靠，不同 JDK 版本行为不一，仅作临时调试参考：
- 启动时加参数：
-Dsun.zip.encoding=UTF-8 - 仅对后续用
ZipInputStream读取的 ZIP 生效（且前提是 ZIP 中启用了 UTF-8 flag） - 不能保证压缩输出是 UTF-8，也不推荐用于生产环境
为什么不用原生 ZipOutputStream？
java.util.zip.ZipOutputStream 构造 ZipEntry 时，内部调用 name.getBytes()，隐式使用平台默认编码；你无法传入 Charset，也无法修改其字节写入逻辑。即使手动转 UTF-8 字节数组，也绕不过 ZIP 条目头结构限制——它不携带编码标识，接收方只能靠猜测或平台约定解析。
强行 hack JDK 源码（如重写 ZipOutputStream）风险高、维护难、升级即失效，不建议。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
