Java创建CSV文件的三种实用方法详解

2026-07-17 10:22:00 作者：缺点内向

在 Java 开发中,CSV（逗号分隔值）作为一种轻量级、跨平台的通用数据格式,广泛用于报表导出、数据迁移和系统间数据交互等场景,本文将介绍如何利用 Spire.XLS for Java 库,通过三种方式创建 CSV 文件,有需要的小伙伴可以了解下

在 Java 开发中，CSV（逗号分隔值）作为一种轻量级、跨平台的通用数据格式，广泛用于报表导出、数据迁移和系统间数据交互等场景。虽然看似简单，但生产级应用中往往需要处理特殊字符转义、编码适配等问题，手动实现不仅代码繁琐，还容易出现兼容性隐患。本文将介绍如何利用 Spire.XLS for Java 库，通过三种方式创建 CSV 文件：从零构建、从数组批量写入，以及将现有 Excel 文件转换为 CSV。

该库的一个特点是独立于本地安装的 Microsoft Office 环境运行，可以在服务器端或没有图形界面的 Linux 环境中部署和使用。

环境配置

在开始之前，需要在 Java 项目中引入 Spire.XLS for Java。如果使用 Maven，在 pom.xml 中添加以下配置即可：

<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>16.4.1</version>
</dependency>

对于非 Maven 项目，可以手动下载 JAR 包并添加到项目的构建路径中。

方式一：从零构建基础 CSV 文件

这是最基础的使用方式，适用于从头创建数据量较小的 CSV 文件。核心思路是创建一个 Workbook 实例，通过 Worksheet 向单元格写入数据，最后调用 saveToFile() 方法导出为 CSV。

import com.spire.xls.*;
import java.nio.charset.Charset;

public class CreateBasicCSV {
    public static void main(String[] args) {
        // 创建 Workbook 实例
        Workbook workbook = new Workbook();
        
        // 获取第一个工作表
        Worksheet sheet = workbook.getWorksheets().get(0);
        
        // 写入表头
        sheet.getCellRange("A1").setValue("ID");
        sheet.getCellRange("B1").setValue("商品名");
        sheet.getCellRange("C1").setValue("价格");
        sheet.getCellRange("D1").setValue("数量");
        
        // 写入数据行
        sheet.getCellRange("A2").setNumberValue(1001);
        sheet.getCellRange("B2").setValue("无线鼠标");
        sheet.getCellRange("C2").setNumberValue(29.99);
        sheet.getCellRange("D2").setNumberValue(150);
        
        sheet.getCellRange("A3").setNumberValue(1002);
        sheet.getCellRange("B3").setValue("机械键盘");
        sheet.getCellRange("C3").setNumberValue(89.99);
        sheet.getCellRange("D3").setNumberValue(75);
        
        // 将工作表另存为 CSV 文件（逗号分隔 + UTF-8 编码）
        sheet.saveToFile("商品信息.csv", ",", Charset.forName("UTF-8"));
        
        // 释放资源
        workbook.dispose();
    }
}

核心 API 说明：

setValue()：向单元格写入文本值。
setNumberValue()：向单元格写入数值（支持整数和小数）。
saveToFile(filename, separator, charset)：将工作表导出为 CSV，可自定义分隔符和编码。

方式二：从数组批量创建结构化 CSV

在实际开发中，业务数据往往以数组或集合的形式存在。这种方式适合批量导出用户列表、订单记录等结构化数据。

import com.spire.xls.*;
import java.nio.charset.Charset;

public class CreateStructuredCSV {
    public static void main(String[] args) {
        Workbook workbook = new Workbook();
        Worksheet sheet = workbook.getWorksheets().get(0);
        
        // 定义表头
        String[] headers = {"订单号", "顾客名", "订单金额", "状态"};
        for (int i = 0; i < headers.length; i++) {
            sheet.getCellRange(1, i + 1).setValue(headers[i]);
        }
        
        // 批量数据
        String[][] orderData = {
            {"ORD001", "张三", "299.99", "已完成"},
            {"ORD002", "李四", "599.50", "已发货"},
            {"ORD003", "王五", "129.00", "已取消"}
        };
        
        // 遍历写入
        int rowNum = 2;
        for (String[] rowData : orderData) {
            for (int col = 0; col < rowData.length; col++) {
                sheet.getCellRange(rowNum, col + 1).setValue(rowData[col]);
            }
            rowNum++;
        }
        
        sheet.saveToFile("订单信息.csv", ",", Charset.forName("UTF-8"));
        workbook.dispose();
    }
}

与逐个单元格赋值相比，遍历数组的方式更适合处理批量数据，且可以灵活适配 List<List<String>> 或其他动态数据源。

方式三：从 Excel 转换为 CSV

当已有 Excel 格式的数据需要导出为 CSV 用于数据迁移或系统导入时，可以通过 loadFromFile() 加载 Excel 文件，然后直接另存为 CSV。

import com.spire.xls.*;
import java.nio.charset.Charset;

public class ExcelToCSV {
    public static void main(String[] args) {
        // 加载 Excel 文件
        Workbook workbook = new Workbook();
        workbook.loadFromFile("示例.xlsx");
        
        // 获取第一个工作表
        Worksheet sheet = workbook.getWorksheets().get(0);
        
        // 保存为 CSV
        sheet.saveToFile("转换结果.csv", ",", Charset.forName("UTF-8"));
        
        workbook.dispose();
    }
}

核心流程仅三步：加载 Excel → 定位工作表 → 调用 saveToFile() 导出。该库还支持反向操作，即将 CSV 转换为 Excel 工作簿，以便对纯文本数据应用样式、公式等功能。

注意事项

特殊字符处理：当数据包含逗号或双引号时，库会自动按照 RFC 4180 规范进行转义，无需手动处理。例如：sheet.getCellRange("A1").setValue("包含,逗号与\"引号\"的文本");

自定义分隔符与编码：除标准逗号外，该库还支持分号（欧洲地区常用）、制表符等分隔符，以及 UTF-8、UTF-16、GB2312 等编码：

// 使用分号分隔 + UTF-16 编码
sheet.saveToFile("数据.csv", ";", Charset.forName("UTF-16"));

// 使用制表符生成 TSV 文件
sheet.saveToFile("数据.tsv", "\t", Charset.forName("UTF-8"));

资源释放：操作完成后调用 workbook.dispose() 有助于及时释放文件句柄和内存资源。

多工作表导出限制：CSV 格式本质上是纯文本的单表格式，无法在一个文件中保存多个工作表。如需导出多个工作表，需要分别为每个工作表调用 saveToFile() 生成独立的 CSV 文件。

授权说明：该库提供免费版本供开发测试使用，免费版对某些功能或文件处理规模可能存在限制。在项目集成前，建议查阅其授权条款确认是否符合使用场景。

总结

通过 Spire.XLS for Java 提供的 Worksheet 操作和 saveToFile() 方法，可以相对简洁地实现从零构建 CSV、从数组批量写入以及 Excel 转 CSV 三种场景。这种方法避免了手动处理字符串拼接、特殊字符转义和编码问题的复杂性，适合在自动化脚本或服务端应用中使用。实际使用时，可以根据数据来源和规模选择合适的方式，并留意资源释放与授权条款等细节。

到此这篇关于Java创建CSV文件的三种实用方法详解的文章就介绍到这了,更多相关Java创建CSV文件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！