Java 中高效读写 CSV 文件并转换为数组的完整实践指南-java教程-PHP中文网

Java 中高效读写 CSV 文件并转换为数组的完整实践指南

本文介绍如何使用 opencsv 库在 java 中可靠地读取、写入 csv 文件，并将数据结构化为二维字符串数组或自定义对象数组，兼顾可读性、健壮性与实际工程需求。

本文介绍如何使用 opencsv 库在 java 中可靠地读取、写入 csv 文件，并将数据结构化为二维字符串数组或自定义对象数组，兼顾可读性、健壮性与实际工程需求。

处理 CSV 文件是 Java 数据集成任务中的常见需求。虽然 Java 标准库未提供原生 CSV 支持，但成熟的第三方库（如 OpenCSV）能显著简化开发、规避手动解析的陷阱（如引号嵌套、换行符、逗号转义等）。本文以 OpenCSV 5.x（最新稳定版）为核心，提供生产就绪的读写与数组转换方案。

✅ 推荐依赖（Maven）

<dependency><groupid>com.opencsv</groupid><artifactid>opencsv</artifactid><version>5.7.1</version></dependency>

? 一、读取 CSV 并转为二维 String 数组

OpenCSV 的 CSVReader 可直接将整个文件加载为 List<string></string>，再转为标准二维数组：

import com.opencsv.CSVReader;
import java.io.FileReader;
import java.io.IOException;
import java.util.List;

public class CSVToArray {
    public static String[][] readCSVAsArray(String filename) throws IOException {
        try (CSVReader reader = new CSVReader(new FileReader(filename))) {
            List<string> rows = reader.readAll();
            return rows.toArray(new String[0][]); // 转为 String[][]
        }
    }

    // 使用示例
    public static void main(String[] args) throws IOException {
        String[][] data = readCSVAsArray("data.csv");
        System.out.println("共 " + data.length + " 行，首行字段数：" + data[0].length);
        // 输出第一行：System.out.println(Arrays.toString(data[0]));
    }
}</string>

⚠️ 注意事项：

readAll() 会一次性加载全部数据到内存，适用于中小规模文件（通常 ≤ 10MB）；

大文件请改用流式读取（reader.readNext() 循环），避免 OOM；

默认分隔符为逗号，如需制表符或分号，使用 new CSVReader(new FileReader(f), '\t')。

✍️ 二、写入 CSV（从二维数组出发）

OpenCSV 同样提供简洁的写入能力：

import com.opencsv.CSVWriter;
import java.io.FileWriter;
import java.io.IOException;

public static void writeArrayToCSV(String[][] data, String filename) throws IOException {
    try (CSVWriter writer = new CSVWriter(new FileWriter(filename))) {
        writer.writeAll(List.of(data)); // Java 14+，或 Arrays.asList(data)
    }
}

该方法自动处理字段中的逗号、换行和双引号（如 "Smith, John" 或 "Line1\nLine2"），无需手动转义。

CSV Data Analyzer

{"answer":"加载、探索、清洗、分析与可视化CSV数据，提供统计摘要、相关性、筛选视图及图表以获取洞察。"}

下载

? 三、进阶：映射为类型安全的对象数组

若 CSV 具有明确列结构（如 name,age,email），推荐使用 CsvToBean 将每行转为 POJO，再收集为对象数组，提升可维护性：

import com.opencsv.bean.CsvToBeanBuilder;
import java.util.Arrays;

public class Person {
    private String name;
    private int age;
    private String email;
    // 构造函数、getter/setter（略）
}

// 读取为 Person[] 数组
public static Person[] readCSVAsObjects(String filename) throws IOException {
    try (CSVReader reader = new CSVReader(new FileReader(filename))) {
        CsvToBean<person> csvToBean = new CsvToBeanBuilder<person>(reader)
                .withType(Person.class)
                .withIgnoreLeadingWhiteSpace(true)
                .build();
        return csvToBean.stream().toArray(Person[]::new);
    }
}</person></person>