csv.writer需显式指定quoting参数（推荐QUOTE_ALL）并以newline=""打开文件，才能正确处理含换行符的字段；读取时同样需newline=""，csv模块会自动将CRLF归一化为\n。
csv.writer 会自动处理含换行符的字段，但必须用 quoting=csv.QUOTE_ALL 或类似策略
默认情况下 csv.writer 不会对含换行符（\n）或逗号的字段加引号，导致写入后 CSV 文件结构被破坏——Excel 或 pandas 读取时字段错位、行数变多。关键不是“能不能”，而是“要不要加引号”和“用哪种 quoting 模式”。
最稳妥的做法是显式指定 quoting 参数：
-
csv.QUOTE_ALL：所有字段都加双引号，无论内容 —— 最安全，兼容性最好 -
csv.QUOTE_MINIMAL（默认）：只在含分隔符、引号或换行符时加引号 —— 看似省事，但某些 CSV 解析器（如旧版 Excel）对跨行字段支持差 -
csv.QUOTE_NONNUMERIC：非数字字段加引号，同时尝试转为 float —— 不推荐用于含换行符的文本
示例：
import csv
<p>with open("output.csv", "w", newline="", encoding="utf-8") as f:
writer = csv.writer(f, quoting=csv.QUOTE_ALL)
writer.writerow(["line1\nline2", "normal field"])
writer.writerow(["field with \"quote\"", "another"])
读取含换行符的 CSV 必须用 newline="" 打开文件
这是最容易被忽略的底层细节：Python 的 csv 模块要求文件以 newline="" 模式打开，否则 Windows 下的 \r\n 可能被误判为两行，或导致 csv.reader 提前终止解析。
立即学习“Python免费学习笔记（深入）”；
错误写法（不加 newline=""）：
# ❌ 可能出错
with open("data.csv", "r", encoding="utf-8") as f: # 缺少 newline=""
reader = csv.reader(f)
正确写法：
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
# ✅ 必须写
with open("data.csv", "r", newline="", encoding="utf-8") as f:
reader = csv.reader(f)
for row in reader:
print(row) # 此时 row[0] 可能是包含 \n 的完整字符串
注意：newline="" 不影响内容编码，只是禁用 Python 的 universal newlines 翻译逻辑，把原始换行符交给 csv 模块自己处理。
字段内换行符在读取后仍是 \n，不是 \r\n
csv 模块在解析时会把 CRLF（\r\n）统一归一化为 \n，无论源文件用的是 Unix、Windows 还是 Mac 换行风格。这意味着你不需要额外做 .replace("\r\n", "\n")。
但要注意：
- 如果字段本身含
\r（非\r\n），它会被原样保留 —— 这属于非法 CSV，多数解析器会报csv.Error: expected more data - Excel 在 Windows 上保存 CSV 时可能插入
\r\n作为字段内换行，csv模块能正确识别并还原为单个\n - 用
pandas.read_csv()读取时，默认不支持跨行字段，必须加lineterminator="\n"并确保文件已用newline=""写入
用 csv.DictWriter 时，字段名不能含换行符，但值可以
csv.DictWriter 的 fieldnames 是列头标识，用于匹配字典 key，它本身不参与 CSV 内容解析逻辑。因此字段名里出现 \n 会导致写入失败或列头损坏，而字段值里的 \n 完全没问题（前提是用了合适的 quoting）。
示例：
fieldnames = ["name", "description"] # ✅ 合法
# fieldnames = ["na\nme", "desc"] # ❌ 避免
<p>writer = csv.DictWriter(f, fieldnames=fieldnames, quoting=csv.QUOTE_ALL)
writer.writeheader()
writer.writerow({"name": "Alice", "description": "line one\nline two"})
实际项目中，如果你控制不了输入数据（比如用户上传的描述字段含任意换行），唯一可靠的方式就是坚持用 csv.QUOTE_ALL + newline=""，别试图手动转义或替换换行符 —— CSV 标准本就支持它，只是需要按规范用。
