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 没读到注释元数据。常见原因：

DBeaver Community 26.2.1

DBeaver Community 26.2.1 Windows x64 官方安装包，适用于数据库连接、SQL 开发、数据浏览和管理。

下载

• 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，就能拉取最新注释。