为何Navicat 15在生成ER图时无法显示字段的完整描述信息

Navicat 15 ER图不显示字段COMMENT的直接原因是默认关闭「解析并渲染字段注释」功能，需手动在表属性中将COMMENT内容粘贴至字段Description栏才能显示。

Navicat 15 ER图不显示字段完整描述（COMMENT）的直接原因

不是设置没开，而是默认关闭「解析并渲染字段注释」功能。navicat 15 的 er 图引擎在逆向工程阶段不会主动读取 information_schema.columns.column_comment，除非你手动启用对应选项；且即使读取了，它也不会自动把 comment 渲染到字段行末尾——那是 v16+ 才支持的 ui 层行为。

如何让字段描述出现在ER图里（Navicat 15 实操路径）

Navicat 15 没有「导入时保留列注释」这类图形化开关，必须靠 SQL 预处理 + 手动补录两步走：

• 导出源库建表语句时，确保含 COMMENT 子句：用 SHOW CREATE TABLE t1 核对输出是否含类似 `name` VARCHAR(50) COMMENT '用户姓名' 的内容
• 在 Navicat 中新建空白 ER 图 → 右键画布 → Import from SQL File... → 选择该 SQL 文件
• 导入后双击每张表，在弹出的「表属性」窗口中，手动把 COMMENT 内容复制粘贴到对应字段的 Description 栏（注意：不是 Comment 栏，v15 的字段编辑框里叫 Description）
• 保存后刷新画布，字段下方才会显示该描述文字（位置固定在字段名右侧、类型左侧）

为什么勾选“包含外键关系”也没用？

这个选项只控制关系线是否生成，和字段描述完全无关。常见混淆点：

• Include foreign keys 影响的是表与表之间的连线，不影响字段级元数据
• 字段 Description 是 ER 图模型层属性，不依赖数据库运行时查询，必须显式填入
• 若从 SQL 导入时字段名带空格或中文引号（如 `user name` VARCHAR(20) COMMENT “用户名”），Navicat 15 会静默跳过整条 COMMENT 解析——必须统一改用英文单引号

导出 PNG/PDF 后描述文字被截断或看不见

Navicat 15 的字段容器宽度是硬编码的，不随描述长度自适应。一旦文字超长，就会被裁剪或压进字段名下方极窄区域，肉眼不可见：

• 临时方案：在表属性中缩短描述，控制在 12 个汉字以内（例如用「登录邮箱」代替「用户用于接收系统通知的注册邮箱地址」）
• 规避法：右键表 → Edit Table → 把描述写进字段的 Comment 列（注意这里是数据库层 COMMENT，非 ER 图层 Description），然后导出时勾选「Include table descriptions」——这部分会以独立文本块显示在表下方，不被截断
• 致命限制：Navicat 15 不支持在导出图像时放大字段区域，Canvas Properties 里没有相关缩放粒度控制项

Navicat 15 的字段描述显示机制是“静态填空”，不是“动态绑定”。所有你以为该自动出现的文字，其实都得亲手敲进去，且要避开引号、空格、超长这三道隐形门槛。