CSV字段含逗号、双引号或换行符时必须用双引号包裹且转义内部双引号为""，并写入UTF-8 BOM（\xEF\xBB\xBF）以避免Excel中文乱码。
用 std::ofstream 写 CSV 时，字段含逗号或换行会直接破坏格式
CSV 不是简单用 , 拼接字符串——只要某个字段本身含逗号（如地址字段 "Beijing, Chaoyang District"）、双引号或换行符，就必须加双引号包裹，且内部的双引号要转义为两个双引号（""）。否则 Excel 打开会错列、甚至整行偏移。
实操建议：
- 不要手写拼接，封装一个
escape_csv_field()函数处理每个字段 - 所有字段无论是否含特殊字符，统一用双引号包裹更稳妥（部分解析器要求如此）
- 换行符必须转为
\n并包裹在双引号内，不能裸写\n到流中
std::string escape_csv_field(const std::string& s) {
bool needs_quotes = s.find(',') != std::string::npos ||
s.find('"') != std::string::npos ||
s.find('\n') != std::string::npos ||
s.find('\r') != std::string::npos;
if (!needs_quotes) return s;
std::string escaped = "\"";
for (char c : s) {
if (c == '"') escaped += "\"\"";
else escaped += c;
}
escaped += "\"";
return escaped;}
用 std::ofstream 写入时，中文乱码问题出在编码和 BOM
Windows 上 Excel 默认用 GBK 解析无 BOM 的 UTF-8 文件，结果就是中文全变成问号或方块。这不是 C++ 流的问题，而是编码声明缺失。
立即学习“C++免费学习笔记（深入）”；
实操建议：
- 导出 UTF-8 CSV 时，在文件开头写入 UTF-8 BOM：
\xEF\xBB\xBF - 不要依赖
.imbue()或 locale 设置——std::ofstream对 UTF-8 文本写入基本不生效 - 确保源字符串是 UTF-8 编码（例如 Qt 用
.toUtf8().constData()，普通 string 字面量在 UTF-8 源文件中即可）
std::ofstream file("report.csv", std::ios::out | std::ios::binary);
file << "\xEF\xBB\xBF"; // write BOM
file << escape_csv_field("姓名") << "," << escape_csv_field("部门") << "\n";
file << escape_csv_field("张三") << "," << escape_csv_field("研发部") << "\n";
file.close();
std::endl 和 "\n" 在 CSV 写入中性能差异明显
每行末尾用 std::endl 会强制刷新缓冲区，对千行以上报表意味着上千次系统调用，速度可能慢 3–5 倍。而 "\n" 只是写入换行符，由缓冲区自动刷盘。
实操建议：
- 一律用
"\n"，写完再调file.flush()或靠析构自动刷新 - 若需实时查看进度（调试用），才临时改用
std::endl - 避免在循环内混合使用：比如字段用
operator，结尾却写file ——风格不一致且低效
用 fopen + fprintf 写 CSV 更轻量，但要注意 %s 不自动转义
如果项目不允许 STL 流（如嵌入式或极致性能场景），C 风格 fopen 更直接。但它完全不处理 CSV 转义——fprintf(fp, "%s,%s\n", a.c_str(), b.c_str()) 是危险操作。
实操建议：
- 仍需先调用
escape_csv_field()得到安全字符串，再传给fprintf - 打开文件必须用
"wb"模式（尤其 Windows），否则文本模式会把\n换成\r\n，而 BOM + \r\n 组合在某些 Excel 版本里会识别异常 - 不用
std::ofstream就无法依赖 RAII，务必检查fopen返回值并手动fclose
FILE* fp = fopen("report.csv", "wb");
if (!fp) return;
fputs("\xEF\xBB\xBF", fp);
fprintf(fp, "%s,%s\n",
escape_csv_field("ID").c_str(),
escape_csv_field("备注").c_str());
fclose(fp);BOM、字段转义、二进制写入模式——这三个点漏掉任意一个，生成的 CSV 在 Excel 里就大概率打不开或显示错乱。别信“只是个文本文件所以随便写”的经验。
