根本原因是CSV字段内含换行符但未被双引号正确包裹，导致DBeaver的DataImporterCSV模块误将内容换行识别为记录分隔；需在导入向导中启用引号解析、关闭空白折叠，并确保源文件符合RFC 4180标准。
CSV 文件里含换行符，DBeaver 导入时列错位怎么办
根本原因是 DBeaver 的 DataImporterCSV 模块默认按“行”切分数据，而 CSV 标准中允许字段值用双引号包裹、内部含换行符（如 "line1\nline2"）。一旦源文件没加引号或引号不闭合，DBeaver 就会把换行当成记录分隔，导致后续所有列偏移。
- 先用文本编辑器（如 VS Code 或 Notepad++）打开 CSV，搜索
\n是否出现在双引号内；若没有引号包裹，就得预处理 - 在 DBeaver 导入向导的「参数」页，必须勾选
使用引号字符，并确认引号是"（英文双引号），不是中文引号或单引号 - 如果字段含制表符、回车符
\r或其他控制字符，建议用 Python 脚本清洗：用pandas.read_csv(..., lineterminator='\n')读取后统一替换\r\n为空格，再保存为规范 CSV
Excel 导出的 CSV 自动加引号，但 DBeaver 还是解析失败
Excel 导出时确实会为含逗号、换行、引号的字段自动加双引号，但它可能漏掉某些边缘情况——比如字段结尾有空格、引号前有反斜杠、或单元格里嵌了 Excel 特有的 \r（非 \r\n）。DBeaver 的 CSV 解析器对这些不严格兼容。
- 不要依赖 Excel “另存为 CSV”，改用
Save As → CSV UTF-8 (Comma delimited)（Windows Excel 2016+），它比老版更规范 - 导入前在 DBeaver 向导「参数」页手动设置：
引号字符填"，转义字符留空（除非你明确用了反斜杠转义） - 若仍报错“列数不匹配”，打开错误日志（
View → Show Error Log），找类似CSV parse error at line X: unterminated quoted field的提示，说明某行引号没闭合，直接定位到该行修复
目标列是 TEXT 或 JSON 类型，导入后换行消失或变成空格
DBeaver 在列映射阶段默认启用“去除首尾空白”和“折叠空白字符”，这对普通字符串友好，但会吃掉多行文本里的真实换行。这不是编码问题，而是导入逻辑的默认行为。
- 进入「列映射」页后，找到对应的目标列，点击右侧的
...打开转换设置 - 取消勾选
Trim whitespace和Normalize whitespace（这两个选项名在界面中是英文） - 确保目标数据库字段类型支持换行：MySQL 用
TEXT或MEDIUMTEXT，PostgreSQL 用TEXT，别用VARCHAR(255)截断
用 LOAD DATA INFILE 替代图形化导入更可靠
当 CSV 含大量换行、特殊字符且图形化导入反复失败时，LOAD DATA INFILE 是绕过 DBeaver 解析层的硬核方案，由 MySQL 服务端直接处理，规则更稳定。
- 先在 DBeaver 连接属性中启用
allowLoadLocalInfile=true，否则执行会报ERROR 3948 - 确保 CSV 文件路径是 DBeaver 客户端可访问的本地路径（不是服务器路径），命令中写
LOAD DATA LOCAL INFILE '/path/to/file.csv' - 关键参数必须显式声明：
FIELDS TERMINATED BY ',' ENCLOSED BY '"' LINES TERMINATED BY '\n'，其中LINES TERMINATED BY决定如何识别换行，不能省略
真正难的不是操作步骤，而是意识到：DBeaver 图形导入本质是客户端预处理，而换行字段的健壮性取决于你是否掌控了从文件生成、引号规则到数据库字段类型的整条链路。任何一环松动，都会在预览页看起来正常，却在第 10001 行突然崩掉。
