1. CSV 简介
CSV全称是：Comma Separated Values (逗号分隔值)或者 Character Separated Values(字符分隔值)。其文件以纯文本形式存储表格数据（数字和文本）。CSV文件由任意数目的记录组成，记录间以某种换行符分隔；每条记录由字段组成，字段间的分隔符是其它字符或字符串，最常见的是逗号或制表符。每一行记录位于一个单独的行上，用回车换行符CRLF(也就是\r\n)分割。
2. 实现 CSV 文件导出
采用 Apache 开源的 commons-csv 包，详细内容参考 官网
2.1 使用
2.1.1 引入依赖
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-csv</artifactId>
<version>1.7</version>
</dependency>
2.1.2 API
- print(Object value); // 写入一个单元格数据
- printRecord(Iterable<?> values); // 写入一行数据
- printRecords(Iterable<?> values);// 写入多行数据
其他重载方法⬇️
![]()
2.2 封装一个导出方法
/**
* 导出 csv 文件
* [@param](https://my.oschina.net/u/2303379) out 输出流
* [@param](https://my.oschina.net/u/2303379) iter 数据 我这里传 List<List<Object>> 类型
* [@param](https://my.oschina.net/u/2303379) charset 字符集编码
* [@param](https://my.oschina.net/u/2303379) header 表头
*/
public void exportCSVFile(OutputStream out, Iterable<?> iter, String charset, String... header) {
try {
// 写入bom, 防止中文乱码
byte[] bytes = {(byte) 0xEF, (byte) 0xBB, (byte) 0xBF};
out.write(bytes);
OutputStreamWriter osw = new OutputStreamWriter(out, charset);
CSVFormat csvFormat = CSVFormat.EXCEL.withHeader(header);
CSVPrinter csvPrinter = new CSVPrinter(osw, csvFormat);
csvPrinter.printRecords(iter);
csvPrinter.flush();
csvPrinter.close();
} catch (IOException e) {
e.printStackTrace();
}
}
2.3 使用示例
List<List<Object>> lists = new ArrayList<>();
List<Object> list1 = new ArrayList<>();
list1.add("张三");
list1.add(18);
list1.add("男");
lists.add(list1);
List<Object> list2 = new ArrayList<>();
list2.add("李四");
list2.add(20);
list2.add("女");
lists.add(list2);
String[] header = {"姓名", "年龄", "性别"};
// 省略 out
exportCSVFile(out, lists, "UTF-8", header);
![]()
2.4 可能遇到的问题
-
使用 Excel 打开出现中文乱码
上面的示例代码采用的是写入 bom ，编码为 UTF-8 的方式解决的，也有其他方案是使用编码为 GBK。
-
用 Excel 打开后，日期格式会变成 ### 或者 2019/01/01 以及较大数字会变成科学技术法
写数据时加上制表符，一个制表符不够，就 2 个
不要调用 printRecords(); 方法，而是通过遍历数据调用 csvPrinter.print("\t"+ 数据 +"\t");
public void exportCSVFile(OutputStream out, Iterable<?> iter, String charset,String... header) {
try {
// 写入bom, 防止中文乱码
byte[] bytes = {(byte) 0xEF, (byte) 0xBB, (byte) 0xBF};
out.write(bytes);
OutputStreamWriter osw = new OutputStreamWriter(out, charset);
CSVFormat csvFormat = CSVFormat.EXCEL.withHeader(header);
CSVPrinter csvPrinter = new CSVPrinter(osw, csvFormat);
Iterator<?> iterator = iter.iterator();
while (iterator.hasNext()) {
Collection list = (Collection)iterator.next();
// 开始写一行数据
list.forEach(c->{
try {
csvPrinter.print("\t" +c.toString() +"\t" );
} catch (IOException e) {
e.printStackTrace();
}
});
// 写完一行，需要换行
csvPrinter.println();
}
csvPrinter.flush();
csvPrinter.close();
} catch (IOException e) {
e.printStackTrace();
}
}
注意： 添加了制表符之后，用文本编辑器打开后，格式就会变得很难看, 如下图所示： ![]()
