MySQL字段注释必须在CREATE TABLE或ALTER TABLE ADD COLUMN时用COMMENT显式声明，Navicat需点击「保存」触发DDL执行，否则注释不生效；注释最大1024字符，导出SQL需手动勾选Export comments。
MySQL建表时直接加字段注释，别等后期补
字段注释必须在 create table 或 alter table ... add column 时用 comment 显式声明，navicat 的可视化界面只是帮你生成这条语句——它本身不存储“未提交”的注释。
常见错误现象：DESCRIBE table_name 看不到注释，或者 Navicat 表设计页里填了“备注”但刷新后消失，本质是没点「保存」或没执行 DDL。
- 建表时每个字段后面紧跟
COMMENT '说明文字'，例如：user_name VARCHAR(50) NOT NULL COMMENT '用户登录名' - 修改字段注释必须用
ALTER TABLE ... MODIFY COLUMN或CHANGE COLUMN，仅ALTER TABLE ... COMMENT只改表级注释 - 注释内容建议用英文单引号包裹，避免中文引号、换行符或未转义的单引号导致语法报错
Navicat 中改字段注释的实际操作路径
Navicat 不是“所见即所得”，它的表设计窗口里编辑「Comment」列只是缓存，真正生效要触发 DDL 执行。很多人点了保存就以为完事，其实卡在最后一步。
使用场景：已有表需补充字段说明，或重构时调整注释内容。
- 右键表 → 「设计表」→ 在「Comment」列输入文字 → 必须点击左上角「保存」按钮（不是 Ctrl+S，也不是关闭窗口）
- 如果提示「需要执行 ALTER 语句」，点「是」；若静默无反应，说明 Navicat 检测到无实质变更（比如只改了空格或全角/半角符号），得微调字段定义再试
- 执行后可立即运行
SHOW FULL COLUMNS FROM table_name验证，Comment列应有值；SELECT COLUMN_COMMENT FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME='xxx'更可靠
表注释和字段注释的写法与存储位置差异
表注释和字段注释在 MySQL 内部存储位置不同，影响备份还原和跨版本兼容性。忽略这点，迁移库时注释可能全丢。
参数差异：表注释通过 COMMENT 表选项设置，字段注释是列定义属性，二者语法不能混用。
- 建表时加表注释：
CREATE TABLE t (id INT) COMMENT='用户主表'；字段注释必须挂在字段后，不能集中写 - 字段注释最大长度 1024 字符，表注释也是 1024，超长会被截断且无警告
- MySQL 5.7+ 支持，但某些旧版客户端（如部分 JDBC 驱动）读
INFORMATION_SCHEMA时可能忽略COLUMN_COMMENT字段，别依赖它做自动化文档生成
Navicat 导出 SQL 时注释丢失的典型原因
导出的 SQL 文件里没有 COMMENT，不是 Navicat bug，而是导出设置默认关掉了结构注释项——这是最常被忽略的配置点。
性能影响几乎为零，但协作时缺失注释会让下游开发者反复查代码或问人。
- 导出前点「导出向导」→ 「高级」选项卡 → 勾选
Export comments（不是「Export table structure」或「Add DROP TABLE」） - 如果导出的是整个数据库，还要确认「对象」页里勾了「表」和「视图」，因为注释只存在这两类对象中
- 用命令行
mysqldump --comments同样生效，但 Navicat GUI 里这个开关藏得深，很多人根本没找过
INFORMATION_SCHEMA 正式收录的元数据；没写进 DDL 的，就不算存在。 
