Hutool 的CsvUtil是一个简单易用的 CSV 文件读写工具类基于 RFC 4180 标准实现。一、添加依赖dependency groupIdcn.hutool/groupId artifactIdhutool-all/artifactId version5.8.26/version /dependency二、读取 CSV1. 从文件读取// 方式1获取 CsvReader 对象 CsvReader reader CsvUtil.getReader(); // 读取所有行 ListCsvRow rows reader.read(FileUtil.file(test.csv)); // 方式2直接读取为 List ListCsvRow rows CsvUtil.getReader().read(FileUtil.file(test.csv)); // 遍历每一行 for (CsvRow row : rows) { // 通过索引获取值 String name row.get(0); String age row.get(1); }2. 带表头读取CsvReader reader CsvUtil.getReader(); // 从第二行开始读取第一行为表头 ListCsvRow rows reader.read(FileUtil.file(test.csv), 1); // 获取表头 CsvRow header rows.get(0);3. 读取为 MapCsvReader reader CsvUtil.getReader(); // 第一行为 key后续行转为 Map ListMapString, String mapList reader.readMapList(FileUtil.file(test.csv));4. 流式读取大文件CsvReader reader CsvUtil.getReader(); reader.read(FileUtil.file(large.csv), new CsvReadHandler() { Override public void handle(int rowIndex, ListString row) { // 逐行处理 System.out.println(rowIndex : row); } });三、写入 CSV1. 基础写入// 获取 CsvWriter默认覆盖写入 CsvWriter writer CsvUtil.getWriter(result.csv, CharsetUtil.CHARSET_UTF_8); // 写入单行按列顺序 writer.write( new String[]{张三, 25, 北京}, new String[]{李四, 30, 上海} ); // 写入集合 ListListString rows new ArrayList(); rows.add(Arrays.asList(王五, 28, 广州)); writer.write(rows); writer.close();2. 追加写入// 第二个参数 true 表示追加模式 CsvWriter writer CsvUtil.getWriter(result.csv, CharsetUtil.CHARSET_UTF_8, true); writer.writeLine(赵六, 35, 深圳); writer.close();3. 写入带表头CsvWriter writer CsvUtil.getWriter(result.csv); // 先写表头 writer.writeLine(姓名, 年龄, 城市); // 写数据 writer.writeLine(张三, 25, 北京); writer.writeLine(李四, 30, 上海); writer.close();4. 写入 Bean 集合需配合其他工具// 使用 CsvData 构造 ListCsvRow rows new ArrayList(); rows.add(CsvRow.of(name, age, city)); rows.add(CsvRow.of(张三, 25, 北京)); CsvData data new CsvData(rows); CsvUtil.getWriter(bean.csv).write(data);四、配置选项CsvReader 配置CsvReadConfig config CsvReadConfig.defaultConfig(); // 设置是否首行是表头 config.setContainsHeader(true); // 设置字段分隔符默认逗号 config.setFieldSeparator(,); // 设置文本限定符默认双引号 config.setTextDelimiter(); // 跳过空行 config.setSkipEmptyRows(true); // 忽略表头大小写 config.setHeaderAlias(new HashMap()); CsvReader reader CsvUtil.getReader(config);CsvWriter 配置CsvWriteConfig config CsvWriteConfig.defaultConfig(); // 设置字段分隔符 config.setFieldSeparator(,); // 设置是否总是使用文本限定符 config.setAlwaysDelimitText(false); // 设置换行符 config.setLineDelimiter(LineDelimiterUtil.CRLF); CsvWriter writer CsvUtil.getWriter(config.csv, CharsetUtil.CHARSET_UTF_8, false, config);五、完整示例示例1读取并处理 CSVpublic class CsvReadExample { public static void main(String[] args) { // 读取 CSV ListCsvRow rows CsvUtil.getReader().read(FileUtil.file(users.csv)); for (int i 0; i rows.size(); i) { CsvRow row rows.get(i); System.out.printf(第%d行: 姓名%s, 年龄%s, 邮箱%s%n, i 1, row.get(0), row.get(1), row.get(2)); } } }示例2生成 CSV 报表public class CsvWriteExample { public static void main(String[] args) { CsvWriter writer CsvUtil.getWriter(report.csv, CharsetUtil.CHARSET_GBK); // 写入表头 writer.writeLine(序号, 姓名, 成绩); // 写入数据 for (int i 1; i 10; i) { writer.writeLine(String.valueOf(i), 学生 i, String.valueOf(60 i * 3)); } writer.close(); System.out.println(CSV 文件生成成功); } }示例3处理特殊字符逗号、引号、换行// 包含特殊字符的值会自动被引号包裹 writer.writeLine(张三, 25, 北京,朝阳区); // 自动处理逗号 writer.writeLine(李四, 30, 他\说\你好); // 自动处理引号 writer.writeLine(王五, 28, 第一行\n第二行); // 自动处理换行六、注意事项编码问题中文建议使用 UTF-8 或 GBK 编码大文件处理大文件应使用流式读取避免内存溢出自动关闭CsvWriter实现了Closeable使用后记得关闭特殊字符包含逗号、引号、换行的字段会自动处理空行处理默认会跳过空行可通过配置修改七、与其他工具对比特性Hutool CsvUtilOpenCSVApache Commons CSV易用性⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐功能完整性⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐依赖大小小整合小中中文社区好一般一般对于日常简单的 CSV 操作Hutool 的CsvUtil完全够用且更加简洁。