Navicat中加表注释须右键表选“设计表”,在窗口最下方Comment栏填写;字段注释需右键列头勾选“Comment”列后在每行末尾填写,导出SQL时务必勾选“Include comments”。
在 Navicat 中给表加注释:右键点哪、填哪、填什么
表注释不是写在 sql 里再执行,而是直接改表属性。navicat 里最稳的方式是打开表设计界面(design table),不是双击表名进数据页,也不是在对象浏览器里右键选“编辑”。进错地方就找不到注释输入框。
常见错误现象:Comment 字段灰掉不可编辑、保存后注释没生效、导出 SQL 时没带 COMMENT 子句。
- 必须用
Design Table(右键表 → “设计表”),不是“打开表” - 注释框在窗口最下方,标着
Comment,不是字段列表里的某列 - 填完别只点“保存”,要确认弹窗里选的是“保存更改”,不是“取消”或“关闭”
- MySQL 5.7+ 和 MariaDB 支持表级
COMMENT;SQLite 不支持;PostgreSQL 要用COMMENT ON TABLE命令,Navicat 的图形界面不暴露这个字段
给字段加注释:别漏掉“字段备注”列,它默认不显示
字段注释不是在字段名旁边随便敲字,Navicat 默认隐藏了“备注”列。不手动调出来,你根本看不到输入位置。
使用场景:建新表时顺手写,或修改已有字段描述——比如把 status 注释成“0=待审核,1=已通过,2=已拒绝”,比翻代码强。
- 在
Design Table界面,右键字段列表的任意列头 → 勾选Comment - 这一列出现后,每行末尾才有输入框;空着不填,导出 SQL 就不会有
COMMENT - MySQL 字段注释长度上限 1024 字符;超长会被截断,且 Navicat 不提示
- 如果字段已存在,改完注释要点击工具栏的
Save按钮(磁盘图标),不是按 Ctrl+S —— 后者在 Navicat 里默认是“运行查询”
批量导出带注释的建表语句:别信“导出向导”的默认选项
导出 SQL 时,Comment 默认不包含。哪怕你在 Design Table 里填得再认真,勾错一个选项,生成的 SQL 就只剩干巴巴的 CREATE TABLE。
性能影响没有,但协作和维护成本会陡增——别人拿到 SQL 看不到业务含义。
- 右键表 → “转储 SQL 文件” → “结构和数据” 或 “仅结构” 都行,但下一步关键
- 在导出设置页,务必勾选
Include comments(不是“Add drop statement”那些) - MySQL 模式下,这个选项控制是否输出
COMMENT='xxx';PostgreSQL 模式下,它决定是否生成COMMENT ON COLUMN语句 - 导出后建议快速搜一下
COMMENT,确认字段和表的注释都出现在 SQL 里
注释不显示?检查连接类型和数据库版本兼容性
填了注释却看不见,大概率不是操作问题,而是 Navicat 连的是不支持注释的环境,或者用了错的连接协议。
容易被忽略的地方:Navicat 对不同数据库的注释支持逻辑不一致,不能假设“填了就会显示”。
- MySQL:必须用原生
MySQL连接类型(不是 ODBC 或 JDBC),且服务端版本 ≥ 5.0 - PostgreSQL:Navicat 16+ 才在 Design Table 里显示字段
Comment列;老版本只能靠命令查pg_description - SQL Server:注释走的是扩展属性(
sys.extended_properties),Navicat 不提供图形化入口,得自己写sp_addextendedproperty - 连上后,在对象浏览器里右键表 → “对象信息”,看
Comment栏是否为空——这是最直接的验证方式
注释这事,填得再快也没用,关键在数据库本身认不认、Navicat 连得对不对、导出时有没有漏开关。三者缺一,前面所有操作都白忙。











