导出CSV必须用try-with-resources关闭BufferedWriter,字段含逗号或中文需加英文双引号;导入不可用split(","),应使用OpenCSV或手动解析引号;统一指定UTF-8编码并处理BOM头,Contact应为POJO。

导出通讯录到CSV文件时,BufferedWriter必须手动关闭或用try-with-resources
Java中导出联系人到CSV,常见错误是只调用 write() 却忘记刷新缓冲区或关闭流,导致文件内容为空或不完整。CSV本质是纯文本,用 FileWriter 配合 BufferedWriter 效率更高,但缓冲区不强制刷出就关闭,数据会丢失。
- 务必使用
try-with-resources自动管理资源,避免漏关流 - 每行联系人字段间用英文逗号分隔,中文字段需用英文双引号包裹(如
"张三"),防止含逗号、换行的姓名破坏格式 - 导出前检查集合是否为
null或空,避免NullPointerException或生成空文件
try (BufferedWriter writer = new BufferedWriter(new FileWriter("contacts.csv"))) {
writer.write("姓名,电话,邮箱\n");
for (Contact c : contactList) {
String line = "\"" + c.getName() + "\",\"" + c.getPhone() + "\",\"" + c.getEmail() + "\"";
writer.write(line + "\n");
}
} catch (IOException e) {
System.err.println("导出失败:" + e.getMessage());
}
导入CSV通讯录时,String.split(",") 不能直接处理带逗号的字段
用 split(",") 解析CSV极易出错——只要某个人名里有逗号(比如“王,小明”),就会被错误切分成两个字段,后续赋值全乱。这不是Java缺陷,而是CSV规范本身要求字段可被引号包裹并支持转义。
- 简单场景下可用
OpenCSV库(Maven依赖com.opencsv:opencsv),它自动处理引号、换行、转义 - 若坚持手写解析,必须按字符逐个扫描,识别引号起止,跳过引号内的逗号;不要依赖正则或简单分割
- 注意BOM头:Windows记事本保存的UTF-8 CSV可能带
\uFEFF,读取首行前应先检测并截掉
try (CSVReader reader = new CSVReader(new FileReader("contacts.csv"))) {
List rows = reader.readAll();
for (String[] row : rows.subList(1, rows.size())) { // 跳过表头
if (row.length >= 3) {
Contact c = new Contact(row[0].trim(), row[1].trim(), row[2].trim());
contactList.add(c);
}
}
}
ArrayList 是导出导入的合理中间载体,但要注意序列化兼容性
通讯录数据在内存中通常用 ArrayList 管理,它支持随机访问、动态扩容,适合增删查改后一次性导出。但若后续想用Java原生序列化(ObjectOutputStream)存二进制,必须确保 Contact 实现 Serializable,且所有字段可序列化。
- 不推荐用Java序列化做导出:格式不跨语言、版本升级易反序列化失败、不可读
- 更稳妥的是把
Contact设计为POJO,字段全用基本类型或String,便于转JSON、XML或CSV - 若用
TreeSet等有序集合,导出前建议转成ArrayList再写文件,避免隐式排序干扰原始顺序
中文乱码问题几乎都出在 FileWriter 和 FileReader 的编码未显式指定
Windows默认GBK,Mac/Linux默认UTF-8,而 FileWriter 构造函数不传 Charset 时用系统默认编码。结果就是:在Windows上导出的CSV,用UTF-8编辑器打开全是乱码;反之亦然。
立即学习“Java免费学习笔记(深入)”;
- 统一用
new OutputStreamWriter(new FileOutputStream(...), StandardCharsets.UTF_8)替代FileWriter - 读取时同理,用
new InputStreamReader(new FileInputStream(...), StandardCharsets.UTF_8) - Excel打开UTF-8 CSV需手动选择“UTF-8”编码,或在文件开头加BOM(
\uFEFF)提高兼容性










