DBeaver 导出查询结果时的编码与表头配置

用 DBeaver 导出查询结果时，中文乱码和“第一行没有列名”通常不是 SQL 本身的问题，而是 CSV 导出器的两个选项没有按接收方要求设置。最稳妥的组合是：选择 CSV，把 Encoding 设为 UTF-8，把 Header 设为 top；表头内容再通过 Header format 选择字段标签或描述。

官方地址：https://dbeaver.com/docs/dbeaver/Data-export/

先分清：导出查询结果还是整张表

本文只处理已经执行的 SQL 结果集。这样做的好处是，WHERE、JOIN、GROUP BY 和 ORDER BY 已经决定了导出范围，不会误把整张业务表导出去。下面的查询只用于准备一个有中文列名和中文值的结果集，示例中的输出是说明用的静态结果。

-- 只导出报表需要的列，先把结果范围固定下来
SELECT
    order_no AS 订单号,
    customer_name AS 客户名称,
    order_status AS 订单状态
FROM orders
WHERE created_at >= '2026-10-01'
ORDER BY created_at DESC;

执行完成后，在结果网格中右键，选择 Export data。不要在连接树上直接右键表名，否则进入的是表数据导出路径，筛选条件和当前结果集可能不是同一个范围。

选择 CSV，并确认导出对象

在 Data Transfer 向导的格式选择页选择 CSV，然后继续到设置页。CSV 适合交给 Excel、脚本或其他数据工具继续处理；如果接收方明确要求 XLSX，再改用对应格式，不要为了保留样式而让 CSV 承担表格排版职责。

输出位置要使用一个容易定位的文件名，例如 orders-2026-10.csv。如果向导提供“已获取行”或类似选项，要确认它表示当前结果集中已经加载的行；对于分页加载的大结果集，应按照实际数据量决定是否重新获取完整结果。

中文乱码：把 Encoding 设为 UTF-8

在 CSV 的 Exporter settings 中找到 Encoding，选择 UTF-8。编码决定文件中的字节如何解释，不能靠修改列名、重新执行 SQL 或更换分隔符来修复编码不匹配。

如果接收方是较旧的 Windows 表格工具，打开后仍然显示异常，先确认它的导入向导是否允许手动选择 UTF-8；不要直接把 DBeaver 的输出改成系统默认编码，因为这会让同一文件在不同机器上表现不一致。导出完成后，用文本编辑器或接收方的“从文本导入”入口确认中文值和列名均可读。

表头缺失：设置 Header 与 Header format

Header 控制 CSV 是否输出表头以及表头在文件中的位置。普通数据交换建议设为 top，这样第一行就是列名；如果下游接口要求纯数据行，才选择 none。bottom 很少用于常规导出，除非接收格式明确要求表头放在末尾。

Header format 决定列名写成什么：label 适合让业务人员阅读，description 适合字段说明已经维护完整的场景，both 会同时输出两类信息。若接收方按固定字段名匹配，优先使用稳定的 label，并在导出后检查首行是否与接口约定一致。

分隔符和 NULL 是另外两类问题

编码和表头设置好后，仍需看接收方的 CSV 约定。Delimiter 决定列之间使用逗号、制表符等分隔符；字段内容本身包含逗号时，要保持引用或转义规则与接收方一致。NULL string 则决定数据库 NULL 在文件中的表示，空字符串和 NULL 不是同一个业务含义，不能随意填成相同文本。

导出前可以先把配置记成一张小清单：

导出后怎样快速确认没有配错

1. 打开导出的 CSV，先看第一行：需要列名时应能看到订单号、客户名称等字段。
2. 随机查看一条中文数据，确认没有出现乱码，也没有因为换行或分隔符导致列错位。
3. 将文件交给实际接收方导入；如果首行被当作数据，回到 Header 选择 top；如果中文异常，优先在导入端选择 UTF-8。

可以把这次配置保存为数据传输任务，下一次复用时仍要检查目标查询和输出文件位置。保存任务只复用参数，不会替你判断新的查询结果是否应该包含表头。

常见问题

为什么我已经选择 CSV，打开后还是没有列名？

CSV 只是文件格式，是否输出列名由 Header 决定。将 Header 改为 top，并确认没有在下游导入时勾选“首行不是标题”。

UTF-8 和分隔符可以一起解决中文乱码吗？

不能。UTF-8 负责字符编码，Delimiter 负责列的切分；中文乱码先看编码，列错位再看分隔符和字段引用。

label、description、both 该怎么选？

给程序或接口使用时优先选稳定的 label；给人工阅读且字段说明维护较好时可选 description；只有接收方能处理双层表头时才使用 both。

因此，DBeaver 导出查询结果的最小可用配置就是：从当前结果集进入 Export data，选择 CSV，Encoding=UTF-8，需要列名时设置 Header=top，再用 Header format 统一字段写法。导出后先看首行和中文值，通常就能快速定位问题是在导出设置还是在下游导入设置。