Java写CSV时含换行符的字段须用双引号包裹并转义双引号为""，换行符保留在引号内，记录间用newLine()换行，严格遵循RFC 4180规范。
Java 中用 BufferedWriter 写 CSV 文件时，若单元格本身含换行符（如用户评论、多行地址），直接写入会导致 CSV 结构错乱——解析器会误将一个字段里的换行当作整行结束。这不是“要不要换行”的问题，而是“如何让换行被识别为内容而非记录分隔符”。核心解决思路是：**字段包裹双引号 + 内部换行符转义保留 + 严格遵循 RFC 4180 规范**。
必须用双引号包裹含特殊字符的字段
CSV 规范明确要求：当字段值包含逗号、双引号或换行符时，整个字段必须用英文双引号 " 包裹。否则解析器无法区分“字段内的换行”和“记录间的换行”。例如：
- ❌ 错误写法：
张三,北京朝阳区<br>建国路1号,25
→ 解析成 3 行、列数不一致 - ✅ 正确写法：
张三,"北京朝阳区<br>建国路1号",25→ 解析为 1 行 3 列
字段内双引号和换行符要双重转义
仅加外层引号不够。若字段本身含双引号（如 他说："你好"）或换行符（\n 或 \r\n），需按 CSV 标准转义：
- 所有双引号
"替换为两个双引号"" - 换行符
\n和\r\n保留在引号内，不额外替换（不是替换成空格或 \t） - 示例原始值：
他说："换行\n测试"→ 转义后："他说：""换行\n测试"""
用 newLine() 写记录级换行，别用 "\n"
记录之间的换行必须用 BufferedWriter.newLine()，它会自动插入当前系统默认换行符（\r\n 或 \n）。硬写 "\n" 在 Windows 上可能造成 Excel 打开时单行显示。配合 try-with-resources 自动关闭流，确保数据刷盘：
立即学习“Java免费学习笔记（深入）”；
try (BufferedWriter w = new BufferedWriter(new FileWriter("out.csv", false))) {w.write("\"" + escapeCsvField(value) + "\""); // 字段转义+包裹w.newLine(); // 记录结束，用标准换行}
建议封装安全的字段转义方法
避免每次手动拼接。写一个工具方法统一处理：
private static String escapeCsvField(String field) {
if (field == null) return "";
String escaped = field.replace("\"", "\"\"");
return escaped.indexOf(',') > -1 ||
escaped.indexOf('\n') > -1 ||
escaped.indexOf('\r') > -1 ||
escaped.charAt(0) == '"' ||
escaped.charAt(escaped.length() - 1) == '"' ?
"\"" + escaped + "\"" : escaped;
}
