当前位置：首页 > 文章列表 > 文章 > java教程 > Java读取CSV文件，OpenCSV使用教程详解

Java读取CSV文件，OpenCSV使用教程详解

2025-07-05 19:41:35 0浏览收藏

还在为Java处理CSV文件而烦恼吗？本文详解OpenCSV库，助你高效完成CSV文件的读取、写入与对象映射。通过`CSVReader`类，轻松读取CSV文件，并可自定义编码、分隔符，跳过标题行。利用`CSVWriter`类，便捷写入数据，自动处理转义字符，灵活控制引号。更高级的用法，如`CsvToBean`与`BeanToCsv`，能实现CSV与Java对象之间的无缝转换，大幅提升代码可读性和可维护性。掌握OpenCSV，让你的Java CSV处理工作事半功倍！无论是数据导入导出，还是复杂数据结构的处理，OpenCSV都能满足你的需求。

使用OpenCSV库可高效处理CSV文件。读取时用CSVReader类，注意设置编码、分隔符及跳过标题行；写入时用CSVWriter类，自动处理转义且可控制引号；复杂结构可用CsvToBean与BeanToCsv实现对象映射，提升代码可维护性。

如何用Java处理CSV文件？OpenCSV教程

处理CSV文件在Java开发中是很常见的需求，比如读取或导出数据。虽然Java标准库没有直接支持CSV的操作，但借助开源库OpenCSV可以非常方便地完成这些任务。下面是一些实际操作建议，帮助你快速上手。

读取CSV文件

如果你需要从一个CSV文件中读取数据，OpenCSV的CSVReader类是个不错的选择。使用它时要注意编码格式和分隔符设置。

举个例子：
假设你的CSV文件是以逗号分隔的，内容如下：

Name,Age,Email
Tom,25,tom@example.com
Jerry,30,jerry@example.com

你可以这样读取：

try (CSVReader reader = new CSVReader(new FileReader("data.csv"))) {
    List<String[]> rows = reader.readAll();
    for (String[] row : rows) {
        System.out.println("姓名：" + row[0] + "，年龄：" + row[1]);
    }
}

注意：

如果你的CSV文件有标题行，记得跳过或者用withSkipLines(1)来忽略第一行。
分隔符不一定是逗号，也可能是制表符\t或其他符号，可以通过构造CSVReader时传入参数指定。

写入CSV文件

写入CSV通常用于导出数据。OpenCSV提供了CSVWriter类，使用起来也很直观。

比如你想把一些用户信息写入到CSV文件中：

try (CSVWriter writer = new CSVWriter(new FileWriter("output.csv"))) {
    writer.writeNext(new String[]{"Name", "Age", "Email"});
    writer.writeNext(new String[]{"Alice", "28", "alice@example.com"});
}

常见注意事项：

默认写入的内容会自动加上引号，如果不需要可以用构造函数控制。
文件路径要确保有写权限，否则会抛异常。
如果数据中包含逗号或换行符，OpenCSV会自动帮你处理转义，不用担心破坏格式。

使用对象映射简化操作（CsvToBean & BeanToCsv）

当你的数据结构比较复杂时，可以直接将CSV与Java对象映射，避免手动处理数组索引。

例如有一个User类：

public class User {
    private String name;
    private int age;
    private String email;

    // getters and setters
}

读取CSV并转换为对象列表：

try (Reader reader = new FileReader("users.csv")) {
    CsvToBean<User> csvToBean = new CsvToBeanBuilder<User>(reader)
        .withType(User.class)
        .withIgnoreLeadingWhiteSpace(true)
        .build();

    List<User> users = csvToBean.parse();
}

同样地，也可以反过来把对象列表写入CSV：

try (Writer writer = new FileWriter("output.csv")) {
    StatefulBeanToCsv<User> beanToCsv = new StatefulBeanToCsvBuilder<User>(writer).build();
    beanToCsv.write(users);
}

这种方式的好处是代码更清晰、可维护性高，尤其是字段较多的时候。

基本上就这些。OpenCSV功能很全，基本涵盖了读、写、映射等常见场景。刚开始可能觉得配置有点多，但熟悉之后你会发现它比手动处理CSV省事很多。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Java读取CSV文件，OpenCSV使用教程详解》文章吧，也可关注golang学习网公众号了解相关技术文章。