navicat 17 的 er 图不支持直接输入字段注释，必须通过数据库原生命令（如 mysql 的 comment、postgresql 的 comment on column）写入系统表，er 图仅实时读取显示；注释超长、引擎不支持、连接版本差异等均会导致不显示。
navicat 17 的 er 图本身不接受任何“输入”，字段描述必须先写进数据库元数据，er 图只是读取显示——你卡在“输不进去”，大概率是没走对写入路径。
字段注释根本不在 ER 图界面里填
很多人在 ER 图编辑区双击字段、右键选“属性”、甚至拖拽文本框，结果发现所有输入都无效。这不是 Bug，而是设计逻辑：Navicat 的 ER 模型（.nm 文件）不存储字段注释，它只从底层数据库的系统表（如 INFORMATION_SCHEMA.COLUMNS 或 pg_description）实时读取 column_comment 值。你看到的空白，是因为数据库里压根没有这条注释。
- MySQL：注释必须通过
ALTER TABLE ... MODIFY COLUMN ... COMMENT 'xxx'或在「对象信息」→「列」页签中填写后保存 - PostgreSQL：必须执行
COMMENT ON COLUMN t.c IS 'xxx'，Navicat 的图形界面在 PG 连接下不提供字段注释输入框 - SQL Server：需用「对象信息」→「扩展属性」添加类型为
MSSQLTableComment的属性 - SQLite / Access：原生不支持标准字段注释，Navicat 无法读取，也就无法在 ER 图中显示
MySQL 下填了注释却超长被截断
MySQL 字段注释有硬性长度限制：1024 字符。超过部分会被静默丢弃，且 Navicat 不提示。你在「对象信息」→「列」里输入了 1500 字的说明，点保存后看似成功，但查 SHOW FULL COLUMNS FROM t 会发现只有前 1024 字存在——ER 图自然只显示这一截。
- 验证方式：执行
SELECT COLUMN_NAME, COLUMN_COMMENT FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME = 't' AND TABLE_SCHEMA = 'db_name'，直接看数据库存的是什么 - 避免踩坑：写注释前先数字符；若真需长说明，拆成多字段（如
desc_short+desc_detail），或改用表级注释 + 外部文档链接 - 注意空格：开头/结尾的空格可能被截断逻辑误判，建议粘贴后手动删前后空格
PostgreSQL 连接下 ER 图始终空白？别信图形界面
Navicat 17 对 PostgreSQL 的字段注释支持是“半残废”的：你在「设计表」窗口根本看不到 Comment 列，右键表头也勾不出；即使你强行在模型里编辑字段属性并保存，也不会生成 COMMENT ON COLUMN 语句。这是已知限制，不是配置问题。
- 唯一可靠路径：打开查询窗口，手写并执行
COMMENT ON COLUMN users.email IS '主邮箱，用于登录和密码重置'; - 执行后刷新 ER 图（F5 或右键 →「刷新」），注释才会出现
- 批量操作别手敲：用查询窗口跑
SELECT CONCAT('COMMENT ON COLUMN ', table_name, '.', column_name, ' IS ''', REPLACE(column_comment, '''', ''''''), ''';') FROM pg_description d JOIN pg_class c ON d.objoid = c.oid JOIN pg_namespace n ON c.relnamespace = n.oid WHERE n.nspname = 'public';生成补丁脚本
ER 图设置了“显示字段注释”但还是不显示
这个选项只控制渲染开关，不解决数据源问题。常见失效场景比你想的更隐蔽：
- 模型连接的是 MySQL，但实际连到了 MariaDB 10.3 以下版本——旧版 MariaDB 字段注释支持不完整，
COLUMN_COMMENT可能为空 - 字段用了
MyISAM引擎：老式 MyISAM 不支持字段级 COMMENT，必须是InnoDB - 你导出图片时用的是数据库节点下的「ER 图」标签页（只读快照），而不是从 .nm 模型窗口导出——后者才读取模型设置
- 字段名含反引号或特殊符号：某些版本 Navicat 解析
`user_id`时会跳过注释读取，改用无引号的user_id重试
最省事的验证动作：在查询窗口执行 SELECT COLUMN_COMMENT FROM INFORMATION_SCHEMA.COLUMNS WHERE COLUMN_NAME = 'xxx' AND TABLE_NAME = 'yyy'。返回 NULL 或空字符串，就说明问题不在 ER 图设置，而在注释根本没入库。
