Java 导出 Excel 的中午乱码问题解析

在使用 Java 导出 Excel 文件的过程中，有时会遇到中文乱码的问题。这篇文章将介绍导致这个问题的原因，并给出解决方案。

问题原因分析

Excel 文件使用的是一种叫做 "Office Open XML"（OOXML）的格式，它是一种基于 XML 的文件格式。在 OOXML 文件中，文本内容使用的是 Unicode 编码，这样可以支持各种语言包括中文。

然而，当我们使用 Java 导出 Excel 文件时，默认情况下，Java 使用的是 ISO-8859-1 编码，这是一种无法支持中文的编码方式。因此，如果我们直接将中文文本写入 Excel 文件，就会出现乱码问题。

解决方案

为了解决中文乱码的问题，我们可以进行以下步骤：

  1. 使用 UTF-8 编码写入 Excel 文件

    首先，我们需要将 Java 输出的文本内容使用 UTF-8 编码写入 Excel 文件。在 Java 中，我们可以使用 Apache POI 这个开源库来操作 Excel 文件。下面是一个示例代码：

    import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

public class ExcelExportUtil {
    public static void exportToExcel() {
        // 创建一个新的工作簿
        Workbook workbook = new XSSFWorkbook();
        // 创建一个工作表
        Sheet sheet = workbook.createSheet("Sheet1");
        // 创建一个行
        Row row = sheet.createRow(0);
        // 创建一个单元格
        Cell cell = row.createCell(0);
        // 设置单元格的值
        String text = "中文内容";
        cell.setCellValue(new String(text.getBytes("UTF-8"), "ISO-8859-1"));

        // ... 其他操作

        // 保存工作簿到文件
        try (FileOutputStream fileOutputStream = new FileOutputStream("output.xlsx")) {
            workbook.write(fileOutputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

    在上述代码中，我们使用 new String(text.getBytes("UTF-8"), "ISO-8859-1") 将文本内容从 UTF-8 编码转换为 ISO-8859-1 编码。这样可以确保在 Excel 中正确显示中文内容。

  2. 使用字体设置解决乱码问题

    在有些情况下，即使我们使用了正确的编码方式，中文仍然可能会显示为乱码。这是因为 Excel 文件中的字体设置可能不支持中文字符。

    为了解决这个问题，我们可以通过设置单元格的字体来确保中文显示正常。下面是一个示例代码：

    import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

public class ExcelExportUtil {
    public static void exportToExcel() {
        Workbook workbook = new XSSFWorkbook();
        Sheet sheet = workbook.createSheet("Sheet1");
        Row row = sheet.createRow(0);
        Cell cell = row.createCell(0);

        // 创建字体对象
        Font font = workbook.createFont();
        font.setFontName("宋体");
        // 设置字体大小
        font.setFontHeightInPoints((short) 12);
        // 设置是否加粗
        font.setBold(true);

        // 创建单元格样式对象
        CellStyle cellStyle = workbook.createCellStyle();
        cellStyle.setFont(font);

        // 设置单元格样式
        cell.setCellStyle(cellStyle);
        cell.setCellValue("中文内容");

        // ... 其他操作

        try (FileOutputStream fileOutputStream = new FileOutputStream("output.xlsx")) {
            workbook.write(fileOutputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

    在上述代码中，我们通过创建字体对象和单元格样式对象，并将字体对象设置到单元格样式中，来确保中文内容正常显示。

状态图

下面是一个使用 mermaid 语法表示的状态图，展示了导出 Excel 的过程：

stateDiagram
    [*] --> 导出Excel
    导出Excel --> 创建工作簿
    创建工作簿 --> 创建工作表
    创建工作表 --> 创建行
    创建行 --> 创建单元格
    创建单元格 --> 设置单元格值
    设置单元格值 --> 其他操作
    其他操作 --> 保存