必须同时开启“在标题栏中显示列描述”设置并确保数据库字段存在中文COMMENT,否则不显示;路径为窗口→首选项→编辑器→数据编辑器→外观→勾选该选项,且仅对直接查表或SELECT字段名生效。

DBeaver 默认不显示字段中文注释,必须同时满足两个条件:配置项开启 + 数据库字段本身有 COMMENT。只开设置不写注释,或者写了注释但没勾选“显示列描述”,都会白忙活。
怎么让查询结果标题栏显示中文注释
这是最常被问到的场景——执行 SELECT * FROM user 后,列头只显示 id、name,想让它变成 id(主键ID)、name(用户名)。
- 路径是:
窗口 → 首选项 → 编辑器 → 数据编辑器 → 外观,勾选在标题栏中显示列描述 - 点
应用并关闭,立即生效(不用重启) - 注意:这个设置只对「直接查表」或「SELECT 字段名」有效;如果用了别名(
SELECT name AS 用户名)或函数(SELECT COUNT(*)),DBeaver 拿不到原始字段的 COMMENT,就只能显示别名或函数名
为什么开了设置还是不显示中文?常见原因排查
开了设置却看不到注释,大概率卡在这几个地方:
- 数据库里字段根本没写
COMMENT:MySQL 要用ALTER TABLE user MODIFY name VARCHAR(50) COMMENT '用户名'补上;Oracle/PostgreSQL 用COMMENT ON COLUMN user.name IS '用户名' - MySQL 连接 URL 缺少必要参数:在连接编辑页的
驱动属性或 JDBC URL 末尾加?remarks=true&useInformationSchema=true,否则驱动不主动拉取注释 - 字段注释是英文或空格开头:DBeaver 对空白字符敏感,
COMMENT ' 用户名'中的前导空格会导致读取失败,建议用TRIM()检查或重写注释 - 用了视图或子查询:注释只从基表字段继承,视图定义里不会自动带出原字段注释,需手动在视图列上再加 COMMENT(部分数据库不支持)
导航树里怎么让表名旁边显示中文注释
想在左侧数据库导航栏看到 user(用户信息表) 而不是光秃秃的 user,要开另一个开关:
- 路径是:
窗口 → 首选项 → 用户界面 → 导航,勾选显示对象描述 - 效果仅限导航树,不影响查询结果列头
- 该选项依赖数据库元数据是否返回表级 COMMENT;MySQL 8.0+ 默认支持,老版本可能需要
useInformationSchema=true配合 - 如果表注释是乱码,先确认 DBeaver 全局编码设为 UTF-8(
首选项 → 编辑器 → 数据编辑器 → 文本字段编码)
最容易被忽略的一点:字段注释和表注释是两套独立元数据,DBeaver 显示逻辑也分开控制。一个开了另一个没开,或者数据库只写了表注释没写字段注释,都会导致部分位置显示不全。别指望“开了一个就全有”。











