Navicat 16 的 ER 图默认不显示字段注释,需在模型属性窗格中手动勾选“显示字段注释”和“显示表注释”;该设置仅对当前模型生效,且必须从模型窗口导出图片或 PDF 才能保留注释。
Navicat 16 的 ER 图默认不显示字段注释
不是你漏填了,也不是数据库没生效——navicat 16 的 er 图(实体关系图)默认关闭所有注释渲染。哪怕你在 design table 里把每个字段的 comment 都填得清清楚楚,生成的图表里照样只显示字段名和类型。
关键点在于:ER 图的注释开关不在“设计表”界面,也不在右键菜单里,而是在模型(Model)的属性面板中。
必须用“模型”功能,不能直接从数据库右键逆向
很多人误以为右键数据库 → “逆向数据库到模型”就能直接出带注释的图,其实这一步只是创建模型文件,后续还得手动开显式开关。
正确路径是:
- 顶部菜单栏点击 模型 → 新建模型(或打开已有 .nm 项目)
- 左上角 文件 → 从数据库导入…,选中目标库和表
- 导入完成后,右侧属性窗格会自动弹出;若没弹出,按
F4或右键图表空白处 → “属性” - 在属性窗格中找到 显示字段注释 和 显示表注释,两个都勾上
注意:这个设置只对当前模型生效,不是全局配置。换一个模型就得重新勾。
字段注释没显示?先确认数据库层已写入
Navicat 的 ER 图只读取元数据里的 COMMENT 值,它不会“猜”或“缓存”你之前在界面里输过什么。
常见失效原因:
- MySQL 表用了
ENGINE=MyISAM:老版本 MyISAM 不支持字段级COMMENT,必须是InnoDB - PostgreSQL 连接下没执行
COMMENT ON COLUMN:Navicat 的图形界面在 PG 模式下不暴露字段注释输入框,必须手写 SQL 补充 - SQLite 或 SQL Server 连接:这些数据库本身不支持标准
COMMENT语法,Navicat 就无从读取 - 字段注释超长被截断:MySQL 限制 1024 字符,超出部分不入库,也就不会出现在 ER 图里
导出图片或 PDF 时注释消失?检查导出源不是“实时视图”
Navicat 16 有两个地方能生成图:一个是模型(.nm 文件),另一个是数据库连接下的“ER 图”标签页(那个是只读快照)。
只有从 模型窗口 导出(右键图表 → “导出为图像” 或 “导出为 PDF”),才会包含你勾选的注释内容;
如果从数据库连接节点下的“ER 图”标签页直接导出,它压根不走模型设置,注释必然丢失。
顺带一提:导出前建议先点一下图表空白处,确保焦点在图上——否则可能导出成一片空白。











