Navicat 15 模型模块不支持直接导出设计说明文档,仅能生成ER图和DDL脚本;必须先同步模型到数据库,再通过查询INFORMATION_SCHEMA元数据并导出为带标题的.docx文件来生成完整文档。
navicat 15 的模型设计模块本身不生成设计说明文档,它只生成 er 图和 ddl 脚本;要出文档,必须绕道 sql 查询 + 导出流程。
为什么不能直接从“模型”菜单导出文档?
Navicat 15 的「模型」模块(Model)专注可视化建模:拖拽表、连线关系、导出为 PNG/SVG/HTML 格式的 ER 图,或生成 CREATE TABLE 语句。但它没有内置的“导出字段注释+类型说明+约束描述”的文档生成功能。所有声称“模型→一键出 Word”的操作,实际都是误点了「查询」或「导出向导」路径。
真正可行的路径:用模型反推 SQL,再查 INFORMATION_SCHEMA
模型文件(.mwb)本质是 XML,但 Navicat 不开放其结构解析接口。稳妥做法是:先在模型中完成设计 → 同步到数据库(右键模型 → 「同步到数据库」)→ 再用标准元数据查询提取结构。这样能确保文档反映的是最终落地的结构,而非草稿状态。
- 同步前务必勾选「同步注释」和「同步默认值」,否则
COLUMN_COMMENT字段为空 - 若跳过同步、直接查空库,
INFORMATION_SCHEMA.COLUMNS将无数据可查 - 模型中定义的外键名称、索引类型等,不会自动写入
COLUMN_KEY,需额外查KEY_COLUMN_USAGE视图
导出时最容易被忽略的三个参数
在 Navicat 查询结果界面点击「导出」后,以下选项决定文档是否可用:
- 导出格式选
Word 文件 (.docx),不是RTF或HTML——后者无法保留表格边框与中文对齐 - 必须勾选「包含列的标题」,否则导出的 Word 表格第一行是空的
- 「遇到错误继续」建议勾选,避免某张表字段名含特殊字符(如
`order`)导致整个导出中断
字段注释丢失?检查 COLUMN_COMMENT 是否真存在
很多团队在建表时没写 COMMENT,导致导出文档里「字段说明」列全为空。这不是 Navicat 问题,而是源头缺失。验证方式很简单:在查询窗口执行
SELECT COLUMN_NAME, COLUMN_COMMENT FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = 'your_db' AND TABLE_NAME = 'user' LIMIT 5;
如果 COLUMN_COMMENT 返回 NULL,就得回退到建表语句补上 COMMENT '用户昵称',再重新同步模型→数据库。
模型设计只是起点,文档质量取决于元数据是否完整、导出路径是否绕开了“看似快捷实则断链”的按钮。最省事的组合永远是:模型定关系 → 同步落库 → SQL 查 INFORMATION_SCHEMA → 导出带标题的 Word。


















