Jar包解压后中文文件名乱码如何解决？

Question

在Windows系统下使用默认解压工具或部分版本的Java解压包含中文文件名的JAR包时，常出现文件名乱码问题。其根本原因在于JAR包打包时使用UTF-8编码记录文件名，而某些解压工具（如旧版WinRAR或系统自带解压程序）默认采用GBK或本地编码解析，导致字符编码不匹配。如何确保JAR包中的中文文件名在解压后正确显示？这是开发者和运维人员在跨平台部署或资源提取时常遇到的技术难题，需从打包方式、解压工具及系统环境三方面综合排查解决。

Answer 1

让【宝码香车】来帮您解答，本回答参考DeepSeek编写，并整理提供。

如果答案能帮助您，请采纳，非常感谢！
.
每日一句正能量，让它带给您好心情：别让别人的评价，左右你的人生，你才是自己的主角。
.

Jar包解压中文文件名乱码解决方案

问题原因分析

JAR包在打包时使用UTF-8编码记录文件名，而Windows系统的默认解压工具（包括资源管理器自带的解压功能和某些旧版第三方工具）默认使用GBK或系统本地编码解析文件名，导致编码不匹配而产生乱码。

解决方案

方法一：使用支持UTF-8编码的解压工具

推荐工具：

• 7-Zip（最新版本）
• Bandizip
• WinRAR 5.0及以上版本
• PeaZip

使用7-Zip解压示例：

# 使用7-Zip命令行解压
7z x your-package.jar -o输出目录


# 或者直接使用7-Zip图形界面，右键选择"7-Zip" -> "解压到当前文件夹"

方法二：使用Java命令解压

由于JAR包本质上是ZIP格式，可以使用Java自带的jar命令：

# 使用jar命令解压
jar xvf your-package.jar


# 或者使用Java的jar工具类
java -jar your-package.jar

方法三：在代码中指定编码解压

如果需要编程解压，可以在代码中明确指定UTF-8编码：

Java示例：

import java.io.*;
import java.nio.charset.StandardCharsets;
import java.util.zip.ZipEntry;
import java.util.zip.ZipInputStream;


public class JarExtractor {
    public static void extractJar(String jarPath, String outputDir) throws IOException {
        try (ZipInputStream zis = new ZipInputStream(
                new FileInputStream(jarPath), StandardCharsets.UTF_8)) {
            
            ZipEntry entry;
            while ((entry = zis.getNextEntry()) != null) {
                File file = new File(outputDir, entry.getName());
                if (entry.isDirectory()) {
                    file.mkdirs();
                } else {
                    file.getParentFile().mkdirs();
                    try (FileOutputStream fos = new FileOutputStream(file)) {
                        byte[] buffer = new byte[1024];
                        int len;
                        while ((len = zis.read(buffer)) > 0) {
                            fos.write(buffer, 0, len);
                        }
                    }
                }
                zis.closeEntry();
            }
        }
    }
}

方法四：修改系统环境变量（临时解决方案）

对于Windows系统，可以临时设置环境变量：

# 在命令行中设置Java文件编码
set JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8


# 然后执行解压操作
jar xvf your-package.jar

方法五：使用Python脚本解压

import zipfile
import os


def extract_jar_with_utf8(jar_path, extract_to):
    with zipfile.ZipFile(jar_path, 'r') as zip_ref:
        for entry in zip_ref.infolist():
            # 正确处理文件名编码
            filename = entry.filename.encode('cp437').decode('utf-8')
            full_path = os.path.join(extract_to, filename)
            
            if entry.is_dir():
                os.makedirs(full_path, exist_ok=True)
            else:
                os.makedirs(os.path.dirname(full_path), exist_ok=True)
                with open(full_path, 'wb') as f:
                    f.write(zip_ref.read(entry))


# 使用示例
extract_jar_with_utf8('your-package.jar', './extracted')

预防措施

打包时指定编码

使用Maven打包时：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <version>3.2.0</version>
    <configuration>
        <archive>
            <manifestEntries>
                <Built-By>UTF-8</Built-By>
            </manifestEntries>
        </archive>
    </configuration>
</plugin>

使用Gradle打包时：

tasks.withType(Jar) {
    manifest {
        attributes(
            'Built-By': 'UTF-8'
        )
    }
    // 设置文件编码
    archiveFileName.set(project.name + '.jar')
}

推荐工作流程

1. 开发阶段：确保所有开发环境使用UTF-8编码
2. 打包阶段：明确指定使用UTF-8编码打包
3. 部署阶段：使用支持UTF-8的解压工具或Java命令解压

通过以上方法，可以有效解决JAR包解压时中文文件名乱码的问题。