DBeaver ER图默认不显示字段注释，需手动在Diagram Settings中勾选Show column comments并设置Column display mode为Name + Type + Comment；批量生成时需确保数据库权限、驱动配置及字符集正确，刷新可更新注释。
ER图默认不显示字段注释，必须手动开启
DBeaver 的 ER 图默认只显示字段名（name）和类型（type），comment（字段注释）完全隐藏——这不是 bug，是默认关闭的显示选项。即使数据库里已有 COMMENT，图上也不会自动出现，必须进设置里勾选。
在“View Diagram”中启用注释显示
对单张表右键 → View Diagram 后，图打开时右下角会出现蓝色齿轮图标（Settings）。点击它，进入「Diagram Settings」：
- 勾选
Show column comments（关键开关，不勾这个永远不显示） - 可选勾选
Show table comments，让表级注释也浮现在表头下方 -
Column display mode建议选Name + Type + Comment，避免只显示 comment 导致字段名丢失 - 改完点
Apply，当前图立即刷新，无需重启或重开
批量生成 ERD（Generate ERD）时注释不生效？检查连接元数据权限
用右键模式 → Generate ERD 批量出图时，即使设置了 Show column comments，部分字段仍空白——大概率是 DBeaver 没读到注释元数据。常见原因：
- MySQL 用户缺少
SELECT权限访问information_schema.COLUMNS表的column_comment字段 - PostgreSQL 连接未启用
show_comments选项（需在连接编辑器 →Driver properties中添加show_comments=true） - Oracle 用户没被授予
SELECT_CATALOG_ROLE或对ALL_COL_COMMENTS的查询权限 - OceanBase 等较新数据库，驱动版本过低（如
oceanbase-client-2.4.0.jar以下）可能忽略REMARKS字段
注释显示异常：中文乱码或截断
注释能显示但文字是方块、问号或只显示前几个字，本质是字符集解析错位：
- 确认数据库连接的 JDBC URL 包含正确编码参数，例如 MySQL 加
?useUnicode=true&characterEncoding=UTF-8 - DBeaver 全局字体设置（
Window → Preferences → General → Appearance → Colors and Fonts）中，把Basic → Text Font改为支持中文的字体（如Microsoft YaHei、Noto Sans CJK SC） - 某些旧版 DBeaver（
23.3.x及之前）对 PostgreSQL 的pg_catalog注释字段长度限制为 64 字符，超长会被截断；升级到24.1.0+可解决
最常被忽略的一点：字段注释显示依赖「列元数据实时加载」，不是静态缓存。如果改了数据库里的 COMMENT 但图上没更新，别急着重开软件——右键图内任意空白处 → Refresh，或者按 F5，就能拉取最新注释。
