DBeaver导入CSV时中文列名无法映射目标字段，因其仅按顺序或首行严格匹配英文字段名；解决方法是将Excel中文列名手动改为与数据库完全一致的英文名（含大小写、下划线），另存为UTF-8 CSV，并在导入映射页逐列核对目标列，必要时设为跳过。
导入CSV时列名是中文，映射不到目标表字段
直接用Excel原文件导入会失败，DBeaver在“从CSV导入”流程中不识别中文列名与数据库字段的语义匹配。它只按顺序硬映射，或依赖CSV首行（header）严格对应目标表字段名。
解决办法是提前把Excel的中文列名改成和数据库表字段完全一致的英文名，再另存为UTF-8编码的CSV。比如Excel里是“客户姓名”，数据库字段是customer_name，就必须手动改掉——别指望DBeaver自动猜。
- 导出前务必检查Excel首行是否为纯英文、无空格、无特殊字符
- 字段名大小写要和目标表一致（MySQL默认不区分，但PostgreSQL区分）
- 如果表字段用了下划线而Excel是驼峰（如
orderDate→order_date），必须手动改，DBeaver不会做转换
映射界面显示“此映射无需更改”，但数据插歪了
这个提示只是说CSV列数和目标表字段数相等，并不表示顺序或类型对得上。尤其当CSV没有header、或header被误读时，DBeaver会按位置一一对应：CSV第1列→表第1字段，哪怕类型完全不兼容（比如文本往INT字段插）。
务必点开映射配置页，逐列核对右侧“目标列”下拉框选中的字段是否正确。常见错误包括：
- CSV有BOM头导致首列识别失败，映射整体偏移一列
- 目标表有自增主键或默认值字段，但CSV也提供了值，结果冲突报错
- 时间字段格式不匹配：
2024/03/15被当成字符串插入DATETIME，实际需要2024-03-15 00:00:00
想跳过某几列不导入，但映射界面没提供skip选项
DBeaver的CSV导入向导本身不暴露skip映射类型，它只提供“existing”（映射到已有字段）和“create”（新建字段）。但你可以用变通方式实现跳过：
- 在映射页，把不想导入的CSV列对应的目标列手动设为
<none></none>（下拉列表最顶部选项） - 确保该列在目标表中允许NULL，否则导入会因NOT NULL约束失败
- 如果目标表字段有默认值，且你希望走默认逻辑，就更得选
<none></none>，而不是随便配一个字段
注意：<none></none> 不等于 skip 映射类型（后者属于DBeaver内部ETL引擎概念），但在CSV导入场景下效果一致。
用xlSql JDBC直连Excel时，列映射行为完全不同
这是最容易混淆的点：xlSql驱动把每个Sheet当作一张表，列名直接来自Excel首行（启用useHeader=true时），此时映射发生在SQL层，不是DBeaver导入向导里的拖拽操作。
比如执行SELECT name, email FROM "Sheet1$"，name和email必须真实存在于Sheet1第一行；若首行是“姓名,邮箱”，就得写SELECT 姓名, 邮箱 FROM "Sheet1$"——JDBC层不转义、不映射、不猜测。
- Sheet名必须带
$后缀，如"销售数据$"，否则查不到 - 路径含中文需URL编码，
jdbc:xlsql:excel:/Users/张三/报表.xlsx要写成jdbc:xlsql:excel:/Users/%E5%BC%A0%E4%B8%89/%E6%8A%A5%E8%A1%A8.xlsx - xlSql不支持写入（INSERT/UPDATE）所有Excel版本，.xlsx仅限追加模式，改单元格要用POI类库
真正麻烦的是混合场景：你用xlSql查出数据，再想灌进MySQL，中间没有自动字段映射——得靠SQL的AS重命名或ETL脚本对齐。
