Navicat 里加表注释，不是点“备注”字段就完事
表注释在 navicat 中实际存于数据库元数据（如 mysql 的 table_comment），但 navicat 的「表设计」界面里那个「备注」输入框，只影响当前 navicat 本地缓存的显示，**不会执行 alter table ... comment 语句**。真要让注释进数据库、被其他工具或程序读到，必须走 ddl 或专用入口。
- MySQL：右键表 → 对象信息 → 切换到「选项」页 → 修改
Comment字段 → 点「保存」（此时 Navicat 会自动生成并执行ALTER TABLE `t` COMMENT = 'xxx'） - PostgreSQL：不支持表级 COMMENT 存于系统表同位置，Navicat 的「对象信息」中「Comment」字段对应的是
COMMENT ON TABLE，保存即生效 - SQL Server：用「对象信息」→「扩展属性」添加
MSSQLTableComment类型的扩展属性，否则注释不会写入sys.extended_properties
字段注释改了却查不到？检查你改的是哪一层
字段注释同样分「Navicat 显示层」和「数据库真实层」。在「表设计」视图里直接编辑「备注」列，对 MySQL/PostgreSQL 是无效的——它只是本地标签，SHOW FULL COLUMNS 或 \d+ 都看不到。
- MySQL：必须用「对象信息」→「列」页签 → 找到目标字段 → 在右侧「Comment」栏填写 → 保存（触发
MODIFY COLUMN ... COMMENT 'xxx'） - PostgreSQL：同上，「对象信息」→「列」→ 填 Comment → 保存后执行
COMMENT ON COLUMN t.c IS 'xxx' - 字段注释长度限制：MySQL ≤ 1024 字符，PostgreSQL ≤ 10240 字节，超长会被截断且无提示
批量加注释？别手点，用查询窗口 + SQL 更稳
上百个字段逐个开「对象信息」太慢，也容易漏。Navicat 的查询窗口能直接跑标准 SQL，还带语法高亮和执行结果反馈，比图形操作更可控。
- MySQL 批量更新字段注释：
ALTER TABLE `user` MODIFY COLUMN `name` VARCHAR(50) COMMENT '用户昵称';
- PostgreSQL 批量加注释：
COMMENT ON COLUMN orders.created_at IS '订单创建时间戳';
- 注意：MySQL 的
MODIFY COLUMN会重建字段，大表慎用；可改用CHANGE COLUMN（保持类型不变时更轻量） - 执行前先备份：Navicat 查询窗口右上角有「导出结果为 SQL」按钮，顺手把当前结构导一份
注释没同步到下游工具？确认数据库连接用了「兼容模式」
有些团队用 DBeaver、DataGrip 或 ORM（如 SQLAlchemy）读注释，却发现为空——大概率是 Navicat 连接配置里勾选了「使用旧版 MySQL 协议」或「禁用元数据缓存」，导致 information_schema 查询被降级或跳过。
- MySQL 连接设置中，确保「高级」页签下
Use SSL和Allow user variables按需开启，但关键是不要勾选Disable metadata cache - PostgreSQL 连接里，如果启用了「Use Unicode for connection」但服务端 locale 不匹配，
pg_description中的中文注释可能乱码，表现为 NULL 或问号 - 验证是否写入成功：直接在查询窗口运行
SELECT table_comment FROM information_schema.tables WHERE table_name = 't'（MySQL）或SELECT obj_description('t'::regclass)（PG）
