csv解析器支持换行符嵌入单元格，但需遵循rfc 4180规范并采用状态机式解析；轻量级按行切分的解析器会错误截断，推荐使用csv-parser库或手写带引号/转义/跨行逻辑的状态机。
CSV解析器是否支持换行符嵌入单元格
标准CSV规范允许字段用双引号包裹，内部换行符（\n 或 \r\n）是合法的——但绝大多数轻量级解析器（比如用std::getline按行切分再std::stringstream拆逗号）会直接在第一行换行处截断，导致解析错位。真正能处理多行文本的，必须实现「状态机式」解析：识别引号开始、跳过内部逗号和换行、直到匹配闭合引号才结束当前字段。
用csv-parser库避免手写状态机
手动实现带引号/转义/跨行逻辑的CSV解析极易出错。推荐使用成熟的csv-parser（GitHub上by ben-strasser维护），它默认启用RFC 4180兼容模式，能正确处理：
• 带换行的双引号字段（"line1\nline2"）
• 双引号内转义（"abc""def" → abc"def）
• 混合无引号与有引号字段
使用要点：
• 初始化时传入csv::CSVFormat().quote('\"').escape('"')确保引号和转义行为明确
• 不要用for (auto& row : reader)直接遍历——需配合reader.read_row()并检查返回值，因为跨行字段会使单次读取可能暂挂等待后续行
• 若遇到csv::Error::RECORD_INCOMPLETE，说明当前行未闭合引号，继续读下一行合并即可
手动解析时如何检测未闭合引号
若因环境限制必须手写，关键不是“怎么拆逗号”，而是“怎么判断字段还没结束”。核心逻辑是逐字符扫描，维护一个in_quotes布尔状态和escaped标记：
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
bool in_quotes = false;
bool escaped = false;
std::string field;
for (char c : line) {
if (!escaped && c == '"') {
in_quotes = !in_quotes;
continue;
}
if (!escaped && in_quotes && c == '\n') {
// 允许保留换行，不结束字段
field += c;
continue;
}
if (!escaped && in_quotes && c == '"') {
escaped = true; // 下一个"被当作字面量
continue;
}
if (escaped) {
escaped = false;
field += '"';
continue;
}
field += c;
}
注意：
• 单行结束时若in_quotes == true，说明该字段跨行，需缓存field并读取下一行追加
• 不要依赖std::getline的默认换行符切割——改用std::istream::get()逐字符读，或用std::getline(in, line, '\0')禁用自动换行分割（仅当数据源可控）
• Windows换行\r\n需统一归一化为\n再处理，否则状态机会在\r处误判
写入CSV时如何安全包裹含换行的字符串
输出端同样容易踩坑：不是所有字符串都需加引号，只有含逗号、换行或引号的才强制包裹。C++中可这样生成安全字段：
std::string escape_csv_field(const std::string& s) {
if (s.find_first_of(",\"\n\r") == std::string::npos) return s;
std::string out = "\"";
for (char c : s) {
if (c == '"') out += "\"\""; // RFC 4180双写引号
else out += c;
}
out += "\"";
return out;
}
使用时：
• 不要对所有字段无条件加引号——会增大文件体积且某些旧系统不兼容
• 确保换行符在包裹后才插入，即先escape_csv_field(s)再拼接\n
• 写入文件时用std::ofstream以std::ios::binary模式打开，避免Windows下\n被自动转成\r\n破坏结构
多行文本单元格真正的复杂点不在语法本身，而在解析器与写入器两端的状态同步——只要有一端按“每行一条记录”硬切，整个CSV就不可靠。务必确认你用的库或代码是否显式声明支持RFC 4180跨行字段，而不是只说“支持引号”。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
