MySQL LOAD DATA 导入含换行文本时怎么设置转义规则

MySQL LOAD DATA 导入含换行文本时，先要确认“换行”属于哪一层：文件中两个字符 \n 需要由 FIELDS ESCAPED BY 解码成字段内容；真实的行尾由 LINES TERMINATED BY 识别；CSV 中被双引号包住的真实换行，则要配合 ENCLOSED BY 保留在同一字段。不要只改一个 ESCAPED BY 就期待三种边界一起变化。

先区分字段里的换行和记录换行

LOAD DATA 同时解析字段和记录。最容易误判的是：文本里写着两个字符反斜杠加字母 n，并不等于文件已经包含真实换行；默认转义规则会把它解释成换行字符。相反，文件中真实出现的换行通常是记录边界，除非它被引号字段包住。

还要记住 SQL 字符串的第二层转义：'\n' 表示换行，想把反斜杠本身作为转义字符，需要写 '\\'。因此先打开原始文件确认字符，再决定 SQL 写法。

普通转义文本怎么写 LOAD DATA

假设文件使用逗号分隔，物理换行代表记录结束，备注字段中的换行被写成两个字符 \n。这时可以把表头跳过，并显式指定字符集和四个边界：

-- 文件中的 \n 作为备注字段内换行，物理换行仍结束一条记录
LOAD DATA LOCAL INFILE '/data/warehouse.csv'
INTO TABLE warehouse_note
CHARACTER SET utf8mb4
FIELDS TERMINATED BY ','
       ENCLOSED BY '"'
       ESCAPED BY '\\'
LINES TERMINATED BY '\n'
IGNORE 1 LINES
(warehouse_id, warehouse_name, note);

这里的 LOCAL 只决定文件由客户端读取并发送给服务端，不会改变字段转义规则。若文件实际没有引号包围字段，可以去掉 ENCLOSED BY；但字段值中若可能出现逗号或换行，保留引号通常更稳。

CSV 真实多行字段要靠 ENCLOSED BY

另一种输入是 CSV 直接把备注写成真实的多行内容，例如第三个字段从一行延伸到下一行，但整个字段被双引号包住。此时关键不是把 ESCAPED BY 改成换行，而是让解析器知道引号范围：

-- 双引号包住的真实换行属于 note 字段，不是新的记录
LOAD DATA LOCAL INFILE '/data/warehouse-multiline.csv'
INTO TABLE warehouse_note
CHARACTER SET utf8mb4
FIELDS TERMINATED BY ','
       ENCLOSED BY '"'
       ESCAPED BY '\\'
LINES TERMINATED BY '\n'
IGNORE 1 LINES
(warehouse_id, warehouse_name, note);

输入时，OPTIONALLY 不会改变引号的识别方式；它主要影响输出时哪些字段被包围。引号内的逗号、真实换行会留在当前字段，未闭合的引号则会让后续内容出现错位，因此源文件的引号必须成对。

最小核对清单：别把转义、行尾和文件位置混在一起

如果把 ESCAPED BY 设为空字符串，转义序列解释会关闭，\n 就不会自动变成换行；字段里再出现分隔符、引号或行结束符时也更容易产生歧义。非 LOCAL 导入还要满足服务端文件位置、FILE 权限和 secure_file_priv 限制；这属于文件访问问题，不是转义问题。

-- 导入后先抽样，再看 IGNORE/LOCAL 产生的警告
SELECT warehouse_id, CHAR_LENGTH(note), note
FROM warehouse_note
ORDER BY warehouse_id
LIMIT 3;

SHOW WARNINGS LIMIT 20;

最后用原始文件行数、目标表新增行数和几条包含换行的备注做对照。若使用 IGNORE 或 LOCAL 后只看到了“导入成功”，却没有检查警告，数据类型转换或字段数量问题仍可能被悄悄转成警告。

相关问题

为什么写了 ESCAPED BY '\\' 仍然拆行？

它只负责字段内容的转义。若文件里是双引号包住的真实多行 CSV，必须同时设置 ENCLOSED BY；若物理行尾不是 \n，还要调整 LINES TERMINATED BY。

可以把 ESCAPED BY 设置成换行吗？

不建议。它应当是字段内部的单字符转义前缀，记录边界应由 LINES TERMINATED BY 表达；混用会让字段、行和转义序列互相遮蔽。

LOAD DATA LOCAL INFILE 会自动修复格式吗？

不会。LOCAL 改变的是文件读取位置和权限模型，字段分隔、引号、转义、行尾仍需和源文件逐项匹配。

官方语法和字段、行处理规则可继续查阅 MySQL 8.4 LOAD DATA Statement。真正稳妥的做法是先判定源文件属于哪一种换行形态，再只调整对应参数。