Navicat 17模型设计器中字段注释默认不写入数据库也不导出SQL，需依次执行：进入「工具→模型选项」勾选“在生成的SQL中包含注释”，再右键模型执行「同步到数据库」并勾选「同步注释」，否则注释仅存于本地模型。
navicat 17 模型设计器里的字段注释，不会自动写入数据库，也不会出现在导出 sql 中——除非你手动打开两个开关、且操作顺序不能错。
模型里填了字段注释，为什么导出的 CREATE TABLE 没有 COMMENT 子句？
因为模型设计器默认关闭注释导出功能，它只把注释存为本地元数据。哪怕你在每个字段的 Comment 栏敲得再认真，不显式启用选项，生成的 SQL 就是干净的裸语句。
- 进入模型工作区 → 顶部菜单「工具」→「模型选项」→ 勾选
在生成的 SQL 中包含注释 - 这个设置只对后续“同步到数据库”或“导出 SQL”生效；已生成过的 SQL 不会自动补上，必须重新执行导出
- 导出前建议点「预览」，快速扫一眼是否出现
COMMENT 'xxx'，避免白忙活
字段注释填了但没进数据库？检查你用的是哪个入口
模型设计器 ≠ 数据库执行器。你在模型画布里双击表、在字段属性面板填的 Comment，只是逻辑模型层的描述，Navicat 不会自动生成并执行 ALTER TABLE ... MODIFY COLUMN ... COMMENT。
- 真要让注释落库，得走「正向工程」：右键模型 →「同步到数据库」→ 确保勾选「同步注释」（该选项在同步向导的「高级」页）
- 或者跳过模型，直接用「对象信息」→「列」页签修改字段
Comment→ 点击保存按钮（软盘图标），Navicat 才会发MODIFY COLUMN语句 - MySQL 下注释长度上限 1024 字符，超长静默截断；PostgreSQL 是 10240 字节，但 Navicat 模型界面填了也不生效，必须靠
COMMENT ON COLUMN手动补
模型里外键还没建好，就急着填注释？顺序错了会校验失败
模型校验强制要求依赖关系闭环。如果你先拉了一条从 orders 到 users 的外键线，但 users 表还没保存进模型对象列表，验证时就会报 Table 'users' does not exist in model ——此时你填的所有字段注释都卡在未提交状态。
- 必须严格按顺序：建
users表 → 点左上角保存按钮（或 Ctrl+S）→ 再建orders表 → 设置外键 → 最后统一填注释 - 已画好但没保存的表，右键该表 →「保存表」，不是点画布右上角的「保存模型」
- 模型一旦创建，数据库类型不可改；选错 MySQL 8.0 和 5.7，会导致 JSON 类型不可见、
DEFAULT CURRENT_TIMESTAMP语法不识别，连带注释字段可能被忽略
最常被忽略的一点：模型里写的注释，和最终数据库里查到的 information_schema.COLUMNS.COMMENT 是两回事。前者是设计资产，后者才是运行时真实元数据。中间差了一个「同步动作」和一个「权限校验」——没点保存按钮、用户没 ALTER 权，注释就永远停在界面上。
