CSV中含换行符的字段必须用双引号包裹，且内部双引号需转义为两个双引号；否则Excel或pandas解析会错位。应按RFC 4180规范自动判断、转义并包裹，不可手动拼接。
CSV写入时字段含换行符会破坏表格结构
直接把带\n的字符串原样写进CSV，Excel或pandas读取时会误判为新行，导致列错位、解析失败。这不是编码问题，是CSV规范本身要求——换行必须被包裹在双引号内，且内部换行需保持原样。
必须用双引号包裹含特殊字符的字段
CSV标准（RFC 4180）规定：字段若含,、"或\n，必须用"包围；若字段内已有"，需转义为""（两个连续双引号），且整个字段仍需被双引号包裹。
实操建议：
- 不要手拼字符串，用成熟逻辑判断是否需要包裹和转义
- 对每个字段单独处理：先检查是否含
\n、,或"，满足任一即进入引号包裹流程 - 转义只针对
"：把每个"替换成""，不是加反斜杠 - 包裹后，字段前后加
"，再写入文件（注意行尾仍要加\n）
示例（C++伪代码逻辑）：
立即学习“C++免费学习笔记（深入）”；
std::string escape_csv_field(const std::string& s) {
if (s.find_first_of("\",\n") == std::string::npos) return s;
std::string out = "\"";
for (char c : s) {
if (c == '"') out += "\"\""; // 关键：两个双引号
else out += c;
}
out += "\"";
return out;
}
// 使用：out << escape_csv_field(field1) << "," << escape_csv_field(field2) << "\n";
std::ofstream写入二进制模式无帮助，别试
有人以为切到std::ios::binary能绕过换行处理——没用。CSV解析器（包括Excel）根本不看文件打开模式，只按内容规则解析。写入\n就是换行，无论你开不开binary。
常见错误现象：
- 用
std::endl写字段内换行 → 实际输出\r\n（Windows）或\n（Linux），直接撕裂行 - 只包裹不转义
"→ CSV解析器遇到未配对的"直接报错或截断 - 包裹后忘了在字段间加
,→ 所有字段挤成一列 - 用
std::quoted（C++20）但没设escape→ 它默认不处理"内部转义，仅加外层引号
第三方库如csv-parser不解决写入问题
csv-parser、rapidcsv等专注解析，写入能力极弱或干脆没有。它们不会帮你做字段转义和包裹——那是你写入端的责任。
更现实的选择：
- 自己写轻量
escape_csv_field（如上），可控、无依赖、不易出错 - 若项目已用
boost，可用boost::algorithm::replace_all辅助转义，但核心逻辑不变 - 避免用
std::format（C++20）直接格式化含换行的字段——它不识别CSV语义，照样会把\n当普通字符输出
最易被忽略的一点：字段里出现\r（比如从Windows文本剪过来）也要视为换行符处理，否则某些解析器（如旧版Excel）会把它和\n一起当成CRLF，同样破坏结构。
