当前位置：首页 > news >正文

使用 Java 将 Excel 工作表转换为 CSV 格式

news 2025/10/30 8:15:52

在日常开发中，Excel 文件（.xls/.xlsx）是数据存储和交换的常用格式，但在数据导入、批量处理等场景下，轻量且纯文本的 CSV 格式更具优势。本文将介绍如何使用 Spire.XLS for Java 组件，高效实现 Excel 文件到 CSV 格式的转换，涵盖环境准备、核心步骤、完整代码及关键说明，帮助开发者快速落地相关需求。

引入依赖（Maven方式）

在项目的pom.xml文件中添加Spire.XLS的依赖配置（查询最新版本）：

<repositories><repository><id>com.e-iceblue</id><name>e-iceblue</name><url>https://repo.e-iceblue.com/nexus/content/groups/public/</url></repository>
</repositories>
<dependency><groupId>e-iceblue</groupId><artifactId>spire.xls</artifactId><version>15.10.5</version>
</dependency>

Spire.XLS for Java兼容Excel 97-2021的所有版本格式。其API设计简洁，封装了复杂的Excel底层逻辑，代码简单易懂。

免费版 （需注意有限制）

Excel 转 CSV 核心实现步骤

Excel转CSV的核心逻辑是：加载Excel文件 → 定位目标工作表 → 调用转换API保存为CSV格式。以下分 “单工作表转换” 和 “多工作表批量转换” 两种场景展开。

场景1：单个工作表转换为CSV

适用于仅需提取Excel中某一个工作表（如第一个工作表）数据的场景，代码如下：

import com.spire.xls.*;
import java.nio.charset.Charset;public class ExcelToCsvSingleSheet {public static void main(String[] args) {// 创建Workbook对象，加载Excel文件Workbook workbook = new Workbook();workbook.loadFromFile("E:\\PythonExcel\\产品.xlsx");// 获取目标工作表（索引从0开始，0表示第一个工作表）Worksheet worksheet = workbook.getWorksheets().get(0);// （可选）若已知工作表名称，可通过名称获取：workbook.getWorksheets().get("Sheet1")// 将工作表保存为CSV格式，指定输出路径、分隔符和编码（UTF-8避免中文乱码）worksheet.saveToFile("single_sheet.csv", ",", Charset.forName("UTF-8"));// 释放资源workbook.dispose();}
}

代码说明

加载Excel文件：Workbook是Spire.XLS的核心类，负责Excel文件的整体管理，loadFromFile()方法支持加载.xls和.xlsx格式；
获取工作表：通过索引（get(0)）或名称（get("Sheet1")）定位工作表，需确保索引不越界（若Excel只有1个工作表，索引最大为0）；
保存为CSV：saveToFile()的第三个参数指定编码（推荐UTF-8，避免中文乱码），若不指定编码，默认使用系统编码（可能导致乱码）。

CSV 输出文件：
在这里插入图片描述

场景2：多工作表批量转换为CSV

若Excel文件包含多个工作表，需将每个工作表单独转为CSV（如Sheet1.csv、Sheet2.csv），可通过遍历工作表实现批量转换：

import com.spire.xls.*;
import java.nio.charset.Charset;public class ExcelToCsvMultiSheets {public static void main(String[] args) {// 加载Excel文件Workbook workbook = new Workbook();workbook.loadFromFile("E:\\PythonExcel\\数据表.xlsx");// 遍历所有工作表for (int i = 0; i < workbook.getWorksheets().getCount(); i++) {Worksheet worksheet = workbook.getWorksheets().get(i);// 获取工作表名称，作为CSV文件名的一部分String sheetName = worksheet.getName();// 定义CSV输出路径String csvOutputPath = "Output/" + sheetName + ".csv";// 保存为CSVworksheet.saveToFile(csvOutputPath,",", Charset.forName("UTF-8"));}// 释放资源workbook.dispose();}
}