Navicat中字段注释需右键表头勾选Comment列才显示输入框，表注释在设计表窗口底部单独填写；导出SQL须手动开启“Include comments”选项；PostgreSQL字段注释必须用COMMENT ON COLUMN语句执行。

Navicat字段注释不显示Comment列？先右键表头勾选

不是所有字段行末尾都有输入框——comment列默认是隐藏的。进到「设计表」界面后，必须右键点击字段列表任意列头（比如field或type），在弹出菜单里手动勾选comment。漏掉这步，你根本看不到注释入口。

常见错误现象：点了保存但导出 SQL 没带COMMENT子句；字段名旁边空着，以为能直接敲字，结果敲不进去。

• 只对当前表生效，切换到另一张表要重新勾选
• 勾选后每行末尾出现空白输入框，填完别留空格，否则可能被截断
• MySQL 字段注释最大长度 1024 字符，超长部分 Navicat 不提示、静默截断

表注释在哪填？不是字段列表里，是窗口最下方

表级注释和字段注释位置完全不同：Comment字段在「设计表」窗口最底部，单独一行，标着“Comment”，不是字段列表里的某一列。很多人误以为要写在第一行字段旁，或者去对象浏览器里右键改属性，结果找不到入口。

使用场景：建新表时顺手填，比如用户行为日志表，含点击/曝光/停留时长；已有表补注释也在这里改，改完点工具栏Save按钮（磁盘图标），不是Ctrl+S（那是运行查询）。

• MySQL 5.7+ 和 MariaDB 支持该字段；SQLite 完全不支持表注释
• PostgreSQL 在 Navicat 图形界面里填了也没用，必须手写COMMENT ON TABLE
• 填完点“保存更改”，不是“关闭”或“取消”，弹窗里要确认选中前者

导出SQL没带COMMENT？检查“包含注释”开关

Navicat 导出结构时，默认不包含注释语句。即使你填了所有Comment，导出的 SQL 文件里也不会出现COMMENT='xxx'，除非手动开启选项。

navicatmysql

Navicat For MySQL

下载

操作路径：导出向导 → 「高级」选项卡 → 勾选Include comments（MySQL/MariaDB）或Include comments并确认用了--comments参数（PostgreSQL）。

• PostgreSQL 更麻烦：pg_dump 默认跳过注释，且恢复时COMMENT ON COLUMN必须在CREATE TABLE之后执行，否则报relation does not exist
• MySQL 下如果导出后没看到 COMMENT，回头检查是否在「高级」里漏勾
• 导出前可先点「预览」看生成的 SQL 是否含 COMMENT 子句，避免白忙

PostgreSQL字段注释为什么填了也不生效？必须手写COMMENT ON

Navicat 的「设计表」界面在 PostgreSQL 下只是摆设——你填了Comment列、点了保存、刷新表，注释依然不会入库。PostgreSQL 不通过表结构定义存字段注释，而是靠独立的COMMENT ON COLUMN命令。

真正生效的操作只有：打开查询窗口，执行原生 SQL：

COMMENT ON COLUMN users.email IS '唯一邮箱，用于登录和找回密码';
COMMENT ON TABLE users IS '用户主表，含注册与基础资料';

注意：需要具备目标表的OWNER权限或postgres角色，普通SELECT权限不够。

• Navicat 的可视化编辑器对 PostgreSQL 字段注释完全无写入能力
• 单引号要转义成两个单引号''，或改用$$...$$界定符防截断
• 刷新后看不到注释？不是失败，是 Navicat 缓存了元数据，按F5或右键「刷新」即可

Navicat 对不同数据库的注释支持差异极大，MySQL 可图形化搞定，PostgreSQL 必须写 SQL，SQLite 则连表注释都不支持——别假设一个操作在所有环境都通用。