Navicat 15的ER图标签页不支持连线旁加便签,仅能通过模型(.nm文件)插入便签或写入数据库COMMENT;便签仅存于本地模型,COMMENT才跨工具可见且影响下游。

Navicat 15里不能直接在ER图连线旁加便签注释
Navicat 15 的「ER 图」标签页(即数据库节点下点开的那个视图)本身不支持添加任意文字便签、气泡或浮动说明——它只渲染外键关系线与表结构,没有注释贴纸功能。你右键连线、拖拽、双击,都不会弹出输入框。这个限制常被误认为是界面卡顿或权限问题,其实是产品设计如此。
真正能加业务说明的地方只有两个:表级/字段级元数据注释(COMMENT),以及模型(.nm 文件)里的独立便签对象。
- 如果你当前是在数据库连接树里点开的「ER 图」,那它只是只读快照,所有“添加说明”的尝试都会失败
- 必须先通过「模型」→「从数据库导入」生成一个
.nm模型文件,才能使用便签功能 - 导入后,画布空白处右键 → 「插入便签」,或工具栏点便签图标,即可拖入自由文本框
- 便签内容不会写入数据库,仅保存在本地
.nm文件中,适合团队内部协作时标注逻辑意图(例如:“此处JOIN含状态过滤,非全量关联”)
用「对象信息」写入COMMENT才是让注释跨工具可见的关键
便签虽灵活,但只活在 Navicat 模型里;而真实影响下游(DBeaver、ORM、文档生成器、SQL 审计)的是数据库元数据里的 TABLE_COMMENT 和 COLUMN_COMMENT。尤其当多个表通过复杂 JOIN 构成业务宽表时,光靠便签说不清字段来源,必须靠 COMMENT 显式声明。
Navicat Premium 17.1 Windows x64 历史系列获取入口。该系列扩展 Garnet、PolarDB 等连接支持,并增强可视化查询解释与 Redis 树视图;未核实到公开固定安装包直链。
- 对主表:右键表 → 「对象信息」→「选项」页→填
Comment→ 点「保存」,触发ALTER TABLE `orders` COMMENT = '用户下单主表,含支付状态机与风控拦截标识' - 对关联字段:右键表 → 「对象信息」→「列」页→找到
user_id→ 在右侧Comment栏填「来自 users.id,非冗余字段,JOIN 时需 on u.id = o.user_id」→「保存」 - MySQL 下该操作会执行
MODIFY COLUMN user_id BIGINT COMMENT '...';PostgreSQL 则走COMMENT ON COLUMN orders.user_id IS '...' - 注意:字段
Comment长度上限 1024 字符,超长静默截断,且 Navicat 不提示
导出带注释的 SQL 或图片时,开关必须手动打开
哪怕你把 COMMENT 写得再完整,Navicat 默认导出行为几乎全部忽略它们——不是 Bug,是设计默认关闭。
- 导出建表语句:右键表 →「转储SQL文件」→「高级」选项卡 → 必须勾选
Include comments;否则CREATE TABLE里连一个COMMENT =都没有 - 导出 ER 图为图片/PDF:必须在「模型」窗口(不是数据库下的 ER 标签页)右键画布 →「导出为图像」;且导出前要确认右侧属性窗格已勾选
显示表注释和显示字段注释 - 如果导出后看不到注释文字,优先检查连接「高级」设置是否勾了
Disable metadata cache——勾了就查不到information_schema.TABLES,整个注释链就断了 - 中文注释乱码?补上连接「高级」里的初始化命令:
SET NAMES utf8mb4;,并确保勾选「使用 MySQL 字符集」
复杂关联场景下,注释要区分“技术约束”和“业务含义”
比如 orders 表和 order_items 表之间有外键,但业务上还隐含“一个订单最多 999 行商品”的规则——这种不能靠外键定义,只能靠注释固化。
- 表注释侧重业务定位:
COMMENT = 'C端用户下单主表,含履约状态机(draft/paid/shipped/cancelled),不包含退款记录' - 字段注释侧重数据契约:
order_status VARCHAR(20) COMMENT '枚举值:draft, paid, shipped, cancelled;变更需同步通知履约中台' - 外键字段可叠加来源说明:
shop_id BIGINT COMMENT '归属门店,来自 shops.id;多租户隔离字段,WHERE 条件必带' - 避免模糊表述如“相关ID”“用于关联”,要写清谁是谁的子集、是否允许 NULL、变更是否触发级联、下游依赖哪些服务
便签适合放临时讨论结论,COMMENT 才是长期可执行的契约。两者不互斥,但优先级不同:没写进元数据的注释,等于没写。

















