MySQL LOAD DATA 导入制表符文件时字段转义怎么设置

导入制表符文件时，关键不是把 LOAD DATA 记成一条固定模板，而是让语句里的四组规则和文件真实格式对上：字段之间用什么分隔、特殊字符由谁转义、每行在哪里结束、缺失值怎样表示。对常见 TSV 文件，通常可以从下面这条语句开始：

官方文档：https://dev.mysql.com/doc/refman/8.4/en/load-data.html

如果文件确实是“制表符分列、换行分行、反斜杠转义”，使用 FIELDS TERMINATED BY '\t' ESCAPED BY '\\' 和 LINES TERMINATED BY '\n'；缺失值写成 \N，不要用一个空字段代替所有 NULL。

先把 TSV 的字段合同写清楚

假设文件每行有四列：订单号、客户名、备注、发货时间。真正需要先确认的是：列之间是否为一个 tab，行尾是 LF 还是 CRLF，备注中的 tab 是否被写成 \t，反斜杠是否被写成 \\，缺失时间是否写成 \N。这些字符不是装饰，它们直接决定解析器在哪里切列。

MySQL 8.4 手册给出的默认读取方式是换行分行、制表符分列，并把反斜杠后的特定字符当作转义序列。默认值能工作，但在文件由不同系统或脚本生成时，建议把合同写进 SQL，也方便代码评审。

一条可维护的 LOAD DATA 语句怎么写

下面的示例假设文件带一行表头。没有表头时删掉 IGNORE 1 LINES；文件在客户端机器上时用 LOCAL，文件在服务端允许的目录中时再使用非 LOCAL 形式。

-- 明确 TSV 的分列、转义、换行和表头规则
LOAD DATA LOCAL INFILE '/data/orders.tsv'
INTO TABLE orders
CHARACTER SET utf8mb4
FIELDS TERMINATED BY '\t'
       ESCAPED BY '\\'
LINES TERMINATED BY '\n'
IGNORE 1 LINES
(order_no, customer_name, note, shipped_at);

FIELDS TERMINATED BY 只负责找列边界；FIELDS ESCAPED BY 负责解释 \t、\n、\\ 和 \N 等输入；LINES TERMINATED BY 则负责找行边界。SQL 字符串里的两个反斜杠表示一个实际的反斜杠，所以示例中的写法不要随意删成单个。

转义字符和 NULL 最容易混在一起

在默认反斜杠转义下，文件里的 \t 会成为字段内的 tab，\n 会成为换行，\\ 会保留一个反斜杠，\N 才会被读成 SQL NULL。例如备注内容若要保留字面量 \N，文件中应写成 \\N，否则它会被当成缺失值。

还要区分三种输入：两个分隔符之间什么都没有，是空字符串；未加引号的 NULL 在某些带 ENCLOSED BY 的格式中有特殊规则；默认 TSV 最稳妥的 NULL 标记是 \N。如果目标列是 NOT NULL，加载 NULL 还会按 SQL 模式产生警告或错误，不能只看“导入了多少行”。

列顺序、换行符和字符集一起检查

文件列顺序和表列顺序不同时，必须写列清单；列清单还可以配合用户变量和 SET 做简单预处理，但不要用它掩盖字段数不匹配。Windows 文本常见 \r\n 行尾，如果只写 \n，最后一列可能带上 \r，此时应改成：

-- 只有文件真实使用 CRLF 时才改用双字符行结束符
LOAD DATA LOCAL INFILE '/data/orders.tsv'
INTO TABLE orders
CHARACTER SET utf8mb4
FIELDS TERMINATED BY '\t' ESCAPED BY '\\'
LINES TERMINATED BY '\r\n'
(order_no, customer_name, note, shipped_at);

如果文件是 UTF-8 而数据库默认字符集不同，保留 CHARACTER SET utf8mb4；它描述的是文件内容的字符集，不是客户端执行 SQL 时的 SET NAMES。

最后再看命令返回的 Records、Skipped 和 Warnings。如果使用 LOCAL 时报本地加载能力未开启，先检查客户端的 local_infile 配置以及服务端是否允许，而不是继续改字段转义。这样排查，格式问题和权限问题不会互相干扰。

相关问题

FIELDS ESCAPED BY 可以设置为空吗？

可以，但会关闭转义解释，并可能让字段中的分隔符或行结束符无法可靠区分；除非文件格式明确不需要转义，否则不建议这样做。

空字段会自动变成 NULL 吗？

不要这样假设。空字段通常表达空字符串或触发列默认值，使用 \N 才能明确表达 LOAD DATA 的 NULL 输入。

为什么同一文件在 macOS 和 Windows 导入结果不同？

最常见差异是行尾：macOS 或 Unix 文件多为 LF，Windows 文件常为 CRLF。让 LINES TERMINATED BY 与文件实际字节一致即可。