导入CSV前必须确保字段顺序、数量、类型与目标表严格一致，phpMyAdmin按列位置硬绑定；需正确设置分隔符、包围符、行终止符，处理空值和日期格式，并注意大数据量时的超时与拆分策略。
导入前必须确认表结构完全匹配
csv 文件里的字段顺序、数量、类型必须和目标表的列严格一致，否则会丢数据或报错。phpmyadmin 不做智能映射，它按列位置硬绑定——第一列对应表的第一列，以此类推。
- 用
DESCRIBE table_name查表结构，记下字段名和顺序 - 用文本编辑器打开 CSV，确认首行是字段名（可选），但导入时 phpMyAdmin 默认跳过首行——勾选「使用 CSV 的第一行作为字段名」才启用该行为
- 如果 CSV 有空值，对应字段在表中必须允许
NULL，否则导入中断 - 日期字段如
DATE或DATETIME，CSV 中必须是2024-03-15或2024-03-15 14:30:00格式，不能是 Excel 自带的序列号或中文格式
上传 CSV 时的关键参数设置
在 phpMyAdmin 表页点击「导入」→ 选择文件 → 切换到「CSV」格式 → 展开「格式特定选项」，这里几个参数直接影响成败：
-
字段分隔符：默认逗号，但如果 CSV 是用制表符或分号分隔，必须手动改成\t或; -
字段包围符：大多数 CSV 用双引号"包围含逗号的字段，就填"；若没包围符，留空 -
行终止符：Windows 用\r\n，Linux/macOS 用\n；上传后报“只导入了 0 行”，大概率是这个不匹配 -
忽略重复行勾上可避免主键/唯一索引冲突导致中断，但不会更新已有记录——要更新得用REPLACE或先清空再导
遇到 “Invalid field count” 错误怎么办
这是最常卡住的错误，意思是某一行的字段数跟表列数对不上。不是总数不对，而是某一行出问题——比如某条记录里多了一个未转义的逗号，或者换行符藏在字段里没被包围符包裹。
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
- 用命令行快速检查：
head -n 20 data.csv | awk -F',' '{print NF}' | sort -u，看是否输出不止一个数字 - 用 VS Code 或 Notepad++ 打开 CSV，开启显示所有字符（显示 → 显示符号 → 显示所有字符），找隐藏的
\r、\n或多余引号 - 临时把
字段包围符设为"，再勾选「截断字段值」，能绕过部分格式问题，但可能丢失末尾空格或特殊字符 - 实在不行，先导出表结构建新表，用
LOAD DATA INFILE（需服务器权限）或 Python 脚本清洗后再导
大数据量导入失败或超时
phpMyAdmin 本质是 Web 接口，受 PHP max_execution_time、upload_max_filesize 和内存限制，几百 MB 的 CSV 几乎必然失败。
- 拆分 CSV：用
split -l 5000 data.csv chunk_（Linux/macOS）切成 5000 行一份，逐个导入 - 调大配置（仅限有服务器权限）：修改
php.ini中的max_execution_time = 300、post_max_size = 256M、upload_max_filesize = 256M - 改用命令行：
mysql -u user -p database_name -e "LOAD DATA INFILE '/path/to/data.csv' INTO TABLE table_name FIELDS TERMINATED BY ',' ENCLOSED BY '\"' LINES TERMINATED BY '\n' IGNORE 1 ROWS;" - 注意：
LOAD DATA INFILE要求文件在 MySQL 服务端路径，本地文件得用LOAD DATA LOCAL INFILE，且 MySQL 配置需开启local_infile=ON
xxd 确认原始字节。 
