MySQL LOAD DATA 怎样跳过 CSV 首行

CSV 第一行如果是 id,name,amount 这样的列名，导入 MySQL 时不能把它当成数据行。最直接的写法是在 LOAD DATA 后面加上 IGNORE 1 LINES，它只跳过文件开头的一行；逗号、双引号和换行仍要按文件真实格式配置。

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

我在处理这类导入时会先看文件的前两行，再决定语句。因为“首行跳过了”只解决表头问题，如果分隔符或换行符不匹配，后面的每一行仍可能被读成一个字段，或者因为字段数量不对而产生警告。

先确认首行确实是表头

假设文件内容如下，第一行是字段名，后面才是记录：

id,name,amount
1001,"咖啡豆",39.90
1002,"滤纸",12.50

这里有三个需要同时记住的事实：

• 第一行只跳过一次，IGNORE 1 LINES 不会按列名自动匹配目标表。
• 字段由逗号分隔，文本字段可能由双引号包裹。
• 文件如果来自 Windows，行尾常是 \r\n，不能想当然地按单个 \n 处理。

用 IGNORE 1 LINES 跳过 CSV 首行

目标表可以这样定义：

-- 目标表的列顺序与后面的 CSV 数据列保持一致
CREATE TABLE order_amount (
  id BIGINT NOT NULL PRIMARY KEY,
  name VARCHAR(100) NOT NULL,
  amount DECIMAL(10, 2) NOT NULL
);

如果文件位于 MySQL 服务器允许读取的目录，最小导入语句是：

-- 跳过 CSV 开头的列名行，再按逗号读取数据
LOAD DATA INFILE '/var/lib/mysql-files/orders.csv'
INTO TABLE order_amount
FIELDS TERMINATED BY ','
       ENCLOSED BY '"'
LINES TERMINATED BY '\n'
IGNORE 1 LINES;

关键点是 IGNORE 1 LINES 的位置和含义：它忽略文件开头的第一行，忽略的行不会进入后面的列变量处理。它不是“忽略第一列”，也不会因为首行写着 id,name,amount 就自动完成字段映射。

让字段和换行格式与文件保持一致

MySQL 默认把字段按制表符分隔，而 CSV 通常使用逗号，所以最好明确写出 FIELDS TERMINATED BY ','。如果字符串字段可能被双引号包裹，再写 ENCLOSED BY '"'；如果所有字段不一定都有引号，可以使用 OPTIONALLY ENCLOSED BY '"'。

-- Windows 导出的 CSV 使用 CRLF 行尾时，显式匹配两个字符
LOAD DATA INFILE '/var/lib/mysql-files/orders-windows.csv'
INTO TABLE order_amount
CHARACTER SET utf8mb4
FIELDS TERMINATED BY ','
       OPTIONALLY ENCLOSED BY '"'
LINES TERMINATED BY '\r\n'
IGNORE 1 LINES;

如果行尾配错，常见表现是最后一个字段带有隐藏的回车字符，或者整行解析结果异常。分隔符也一样：把逗号文件按默认制表符读取时，一整行可能会被当作一个字段。

列顺序不同就显式写列清单

表头被跳过不代表列名被使用。如果 CSV 的列顺序是 name,id,amount，目标表却是 id,name,amount，应该在语句末尾声明输入列顺序：

-- 用列清单把输入顺序映射到目标表字段
LOAD DATA INFILE '/var/lib/mysql-files/orders.csv'
INTO TABLE order_amount
FIELDS TERMINATED BY ','
       OPTIONALLY ENCLOSED BY '"'
LINES TERMINATED BY '\n'
IGNORE 1 LINES
(name, id, amount);

遇到多余字段时，可以先接到用户变量，再在 SET 中转换或丢弃：

-- 第二个输入字段先接到变量，避免把导入列顺序写死到表结构
LOAD DATA INFILE '/var/lib/mysql-files/orders-extra.csv'
INTO TABLE order_amount
FIELDS TERMINATED BY ','
       OPTIONALLY ENCLOSED BY '"'
LINES TERMINATED BY '\n'
IGNORE 1 LINES
(id, name, @raw_amount)
SET amount = CAST(@raw_amount AS DECIMAL(10, 2));

服务器文件和客户端文件不是一回事

不带 LOCAL 时，文件由服务器主机读取，通常需要 FILE 权限，并受 secure_file_priv 目录限制。加上 LOCAL 后，文件由客户端程序读取再发送给服务器，文件可以在客户端可访问的目录中，但服务端和客户端都必须允许本地导入。

-- 文件在执行导入命令的客户端机器上时使用 LOCAL
LOAD DATA LOCAL INFILE '/data/orders.csv'
INTO TABLE order_amount
CHARACTER SET utf8mb4
FIELDS TERMINATED BY ','
       OPTIONALLY ENCLOSED BY '"'
LINES TERMINATED BY '\n'
IGNORE 1 LINES;

LOCAL 不是单纯的路径前缀。它会改变文件读取位置、权限要求和部分错误处理方式；如果服务端关闭了 local_infile，语句会直接失败。部署时要先决定导入文件属于服务端还是客户端，再选择对应写法。

用导入结果和警告确认首行没有混入

发布导入任务前，建议先在事务或临时表中试跑同一格式。完成后关注受影响行数、警告数量和首条数据，而不是只看语句是否返回成功。

-- 查看最近一次 LOAD DATA 的警告，定位字段转换或行格式问题
SHOW WARNINGS LIMIT 20;

-- 抽查首条已导入记录，确认表头没有被当成数据
SELECT id, name, amount
FROM order_amount
ORDER BY id
LIMIT 1;

如果业务数据允许重复键，要谨慎选择 IGNORE 或 REPLACE 修饰符。它们与 IGNORE 1 LINES 不是同一个概念：前者控制重复键和部分错误如何处理，后者只负责跳过文件开头的若干行。标题中的“跳过首行”通常只需要后者。

几个容易混淆的边界

表头不止一行：如果文件开头有说明文字和列名两行，就使用 IGNORE 2 LINES，不要用 LINES STARTING BY 代替。后者用于每行共享前缀的场景。

中文显示异常：补上 CHARACTER SET utf8mb4，并确认文件本身确实用 UTF-8 保存。SET NAMES 不会改变 LOAD DATA 对文件内容的解释。

导入成功但数据少：检查是否误用了 LOCAL、目标表是否存在重复键、是否开启了错误忽略，以及 SHOW WARNINGS 是否记录了转换问题。

首行仍然出现：先确认执行的确实是包含 IGNORE 1 LINES 的语句，再检查输入文件是否在开头还有 BOM 或额外说明行。BOM 不会被当成“自动表头识别”。

结论

MySQL LOAD DATA 跳过 CSV 首行的核心写法就是 IGNORE 1 LINES。真正决定导入是否可靠的，是它旁边的格式契约：逗号分隔、双引号包裹、\n 或 \r\n 行尾、字符集、列清单以及文件所在主机必须和实际文件一致。把这些条件固定下来，再用警告和首条记录做一次结果核对，批量导入就不容易把表头、隐藏回车或错位字段带进正式数据。

相关问题

MySQL LOAD DATA 怎样跳过两行说明？把 IGNORE 1 LINES 改为 IGNORE 2 LINES，它按文件开头的行数跳过。

CSV 列顺序与表结构不同怎么办？在语句末尾写输入列清单，必要时使用用户变量和 SET 做转换。

为什么导入后最后一列带回车？通常是 LINES TERMINATED BY 与文件实际行尾不匹配，Windows 文件常需要 '\r\n'。