phpMyAdmin CSV导入只按列位置匹配，不支持字段名映射；必须使CSV列序与表结构一致，并确保编码为utf8mb4、分隔符正确、首行字段名完全匹配且启用“使用第一行作为字段名”选项。
CSV导入时字段顺序不一致，phpMyAdmin会按列位置硬匹配
phpMyAdmin 不支持“按字段名自动映射”，它只认 CSV 的列顺序和目标表的字段顺序。如果你的 CSV 是 email,name,age，但表结构是 id,name,email,created_at，直接导入会导致数据错位（比如 email 写进 name 字段，name 写进 email 字段）。
解决办法只有两个：提前调整 CSV 列序，或用中间表过渡。推荐前者，更可控。
- 用 Excel / LibreOffice 或
csvkit命令行工具重排 CSV 列，使其严格对应目标表的SHOW COLUMNS FROM table_name输出顺序 - 导出表结构参考：
DESCRIBE table_name或在 phpMyAdmin「结构」页查看字段列表 - 首行必须是字段名（启用「使用第一行作为字段名」选项），且字段名要和表中定义完全一致（包括大小写、下划线）
- 如果表有自增主键（如
id），CSV 对应列留空或填NULL，并确保 phpMyAdmin 导入设置里勾选了「允许 NULL 值」
「使用第一行作为字段名」没生效？检查分隔符和引号设置
常见现象：勾选了该选项，但依然报错「列数不匹配」或字段全塞进第一列。根本原因是 phpMyAdmin 没正确解析 CSV 格式——它默认用逗号分隔、双引号包围字段，而你的文件可能是分号、制表符，或用单引号/无引号。
QuickBooks Mileage CSV
下载
使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。
- 在 phpMyAdmin 导入页，展开「格式特定选项」，手动设置：
字段分隔符（如;或\t），字段包裹在（选"、'或无） - Linux/macOS 下可用
head -n1 file.csv | hexdump -C看真实分隔符（逗号是2c，分号是3b，制表符是09） - Windows 记事本另存为 UTF-8 编码，避免 BOM 头干扰；BOM 可能导致首字段名前多出不可见字符，使匹配失败
含中文、特殊字符或换行的字段导入失败
CSV 中字段含换行符（\n）、逗号、双引号时，必须被正确包裹和转义，否则 phpMyAdmin 解析会断行或错列。这不是 bug，是 CSV RFC 4180 规范要求。
立即学习“PHP免费学习笔记（深入）”；
- 确保这类字段用双引号包裹，且内部双引号写成两个（
"He said ""OK""."） - 导入前用文本编辑器搜索
\n（非显示换行）确认是否在引号外出现；如有，需先清理或改用LOAD DATA INFILE（需服务器权限） - 字符集必须匹配：phpMyAdmin 页面右上角选择
UTF-8 Unicode (utf8mb4)，CSV 文件也保存为 utf8mb4 编码（不是 utf8） - 若仍乱码，检查 MySQL 表本身字符集：
SHOW CREATE TABLE table_name，确保CHARSET=utf8mb4且COLLATE=utf8mb4_unicode_ci
大数据量 CSV 导入超时或中断
phpMyAdmin 是 Web 界面，受 PHP max_execution_time、upload_max_filesize 和内存限制，通常撑不过 2MB～5MB 的 CSV。
- 临时解法：在导入页把
INSERT 每次插入的行数调小（如 100），降低单次请求压力 - 根本解法：改用命令行
mysql客户端：mysql -u user -p database_name -e "LOAD DATA INFILE '/path/to/file.csv' INTO TABLE table_name FIELDS TERMINATED BY ',' ENCLOSED BY '\"' LINES TERMINATED BY '\n' IGNORE 1 ROWS;"
-
LOAD DATA INFILE要求文件在 MySQL 服务器本地，且用户有FILE权限；若文件在本地机器，用LOAD DATA LOCAL INFILE（需服务端开启local_infile=ON）
DESCRIBE 和 hexdump 这两步。 
