Navicat 修改表注释需点击工具栏“保存”按钮（软盘图标）触发 ALTER TABLE ... COMMENT 才生效，仅编辑、Ctrl+S 或关闭窗口不会提交；MySQL 8.0+下还需确保用户有 ALTER 权限，并注意注释长度≤2048字符、不支持换行符。
Navicat 修改表注释时，为什么保存后不生效？
直接在「设计表 → 表选项卡 → 注释」里编辑并点击保存，但刷新后发现注释没变——这通常不是操作失误，而是 navicat 默认不会自动执行 alter table ... comment 语句。它只把修改记在本地缓存或界面状态里，真正写入数据库需触发 ddl 提交。
- 必须点击工具栏的
保存按钮（图标是软盘），而非仅按 Ctrl+S 或关闭窗口 - 部分版本（如 Navicat Premium 16）在修改表注释后，会弹出确认对话框提示“是否执行 ALTER TABLE”，选“是”才真正提交
- 如果连接的是 MySQL 8.0+，且当前用户没有
ALTER权限，即使点了保存也会静默失败，建议检查 Navicat 底部状态栏是否有报错提示
MySQL 表注释的实际存储位置与限制
表注释存在 information_schema.TABLES 视图的 TABLE_COMMENT 字段中，不是存在表结构定义里。这意味着：
- 注释长度上限为 2048 字符（MySQL 5.7+），超长会被截断，Navicat 不会提前警告
- 注释内容不支持换行符（
\n），粘贴带回车的文本时会被转成空格或丢弃 - 如果用
mysqldump --no-create-info导出数据，表注释会丢失；完整导出需确保含--no-create-db且未加--skip-comments
用 SQL 直接修改比界面更可靠
当界面反复失败、或需批量处理时，绕过 Navicat 界面直连执行 SQL 更可控：
ALTER TABLE `user_info` COMMENT = '用户基本信息表，含注册时间与最后登录IP';
- 执行前确认当前连接的数据库已选中（左上角数据库名高亮），否则可能误改其他库的同名表
- 表名必须用反引号包裹，尤其含短横线或关键字时（如
`order-log`） - 注释内容里的单引号需转义（
'→''），双引号无需转义
修改后如何验证注释真被写入？
别只信 Navicat 的界面显示，用 SQL 查一遍最准：
SELECT TABLE_COMMENT FROM information_schema.TABLES WHERE TABLE_SCHEMA = 'your_db_name' AND TABLE_NAME = 'user_info';
- 返回结果为空字符串（
''）表示注释未设置或已被清空 - 若查不到记录，说明表不存在，或
TABLE_SCHEMA名写错（注意大小写敏感性，Linux 下库名区分大小写） - Navicat 的「对象信息」面板有时缓存旧值，右键表名 → 「刷新」才能同步最新元数据
