Navicat 15中为已有表加备注最直接入口是右键表名→“设计表”,表级注释填入底部Comment框并点保存按钮;字段注释需先右键列头勾选“Comment”才显示输入框,且MySQL字段注释上限1024字符,导出SQL须手动勾选“Include comments”。
在“设计表”界面底部填表注释,不是右键属性或对象信息
navicat 15 中给已有表加备注,最直接有效的入口是「设计表」界面——右键表名 → 选择 设计表(不是“对象信息”“属性”或“编辑表”)。表级注释输入框固定在窗口最下方,标着 comment,填完必须点工具栏的 保存 按钮(磁盘图标),按 ctrl+s 会触发查询执行,不保存结构变更。
常见错误现象:Comment 输入框灰掉、填了但导出 SQL 没有 COMMENT = 'xxx'、刷新后注释消失。这些基本都因为没走对入口:用“对象信息”改的 MySQL 表注释只是本地缓存;用“属性”改的 SQL Server 扩展属性若类型不对(比如没选 MSSQLTableComment),也不会写入 sys.extended_properties。
字段注释要先右键列头勾选“Comment”,否则输入框根本不出现
字段备注不是写在字段名旁边,也不是默认可见。进到 设计表 后,右键字段列表任意列头(如 Field 或 Type),勾选 Comment —— 这一列才会显示在每行末尾。漏掉这步,你连输入位置都找不到。
- 只对当前表生效,切换表要重新勾选
- MySQL 字段注释长度上限
1024字符,超长静默截断,Navicat 不提示 - PostgreSQL 下这个操作无效:填了也进不了数据库,必须手写
COMMENT ON COLUMN语句执行
导出带注释的建表语句,必须手动勾选“Include comments”
你在 设计表 里填得再认真,导出 SQL 时若没开关键开关,生成的 CREATE TABLE 里照样没有 COMMENT 子句。路径是:右键表 → 转储 SQL 文件 → 选“仅结构”或“结构和数据” → 进“高级”选项卡 → 勾选 Include comments。
注意:Include comments 只影响 CREATE TABLE 部分,INSERT 数据部分永远不带注释(语法不允许);如果导出后搜不到 COMMENT=,优先检查是否真写了注释(执行 SHOW FULL COLUMNS FROM table_name 看 Comment 列)、是否用了支持注释的数据库版本(如 MySQL 5.7+)、是否连的是 PostgreSQL 却误以为图形界面能生效。
PostgreSQL 和 SQL Server 的注释机制完全不同,不能套用 MySQL 流程
MySQL 注释靠 ALTER TABLE ... COMMENT,Navicat 图形界面能映射;PostgreSQL 必须走 COMMENT ON TABLE / COMMENT ON COLUMN,Navicat 的 设计表 界面在 PG 下对注释列的操作只是摆设;SQL Server 要用扩展属性,且类型必须是 MSSQLTableComment,否则 sp_addextendedproperty 不会被调用。
最容易被忽略的一点:Navicat 不会校验你填的注释是否已真实写入数据库元数据。它导出的 SQL,只是把库里查到的内容翻成语句。所以填完一定要验证——比如 MySQL 下跑 SELECT TABLE_COMMENT FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_NAME = 't',PG 下查 obj_description(),否则后期维护时发现注释“凭空消失”,其实是从来就没存进去。


















