Java通讯录导入导出实现方法

本文深入剖析了Java中通讯录数据CSV格式导入导出的核心实践与常见陷阱：强调必须使用try-with-resources确保流资源安全释放，严禁依赖String.split(",")解析含逗号或换行的字段，推荐OpenCSV或手写引号感知解析器；统一强制指定UTF-8编码并妥善处理BOM头以根治中文乱码；要求Contact设计为规范POJO，避免Java序列化，同时注重空集合校验、缓冲区刷新、字段引号包裹等关键细节——每一个看似微小的疏忽都可能导致文件损坏、数据错位或批量导入中断，真正实现健壮、跨平台、可维护的通讯录数据交换能力。

导出通讯录到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编辑器打开全是乱码；反之亦然。

• 统一用 new OutputStreamWriter(new FileOutputStream(...), StandardCharsets.UTF_8) 替代 FileWriter
• 读取时同理，用 new InputStreamReader(new FileInputStream(...), StandardCharsets.UTF_8)
• Excel打开UTF-8 CSV需手动选择“UTF-8”编码，或在文件开头加BOM（\uFEFF）提高兼容性

导出导入看着只是读写文件，实际卡点全在细节：缓冲区、CSV语法、编码、边界校验。哪怕一个引号没闭合，整批导入就停在那条记录上——别指望用户去查日志，得在代码里提前兜住。

今天关于《Java通讯录导入导出实现方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！