Navicat Premium 17 不支持“一键发布 HTML 交互式文档”,其模型模块仅提供 PNG、PDF、SVG 和 SQL 导出,无 HTML 选项;需先导出 SQL,再借助 schemacrawler 等外部工具生成交互式 HTML 文档。

Navicat Premium 17 不支持“一键发布 HTML 交互式文档”——它没有内置的文档生成器或静态站点导出功能。所谓“HTML 文档”,必须通过手动导出 SQL + 外部工具转换,或用第三方插件/脚本补足。
为什么点不到“导出为 HTML”菜单
Navicat Premium 17 的模型模块(.nm 文件)只提供结构建模、验证、SQL 导出和图片/PDF 导出能力。顶部菜单栏的 文件 → 导出 下只有 PNG、PDF、SVG 和 SQL,没有 HTML 选项;右键画布、表、关系线均无“生成文档”上下文菜单。
这不是界面隐藏,而是功能缺失:Navicat 把“建模”和“文档化”视为两个分离环节,不打包交付。
可行路径:用 SQL + 开源工具生成交互式 HTML
真正能落地的方案是分两步走:先从模型导出标准 SQL,再用命令行工具转成带搜索、折叠、ER 图嵌入的 HTML 文档。推荐组合:
Navicat Premium 17.1 Windows x64 历史系列获取入口。该系列扩展 Garnet、PolarDB 等连接支持,并增强可视化查询解释与 Redis 树视图;未核实到公开固定安装包直链。
-
navicat中执行模型 → 工具 → 正向工程 → 生成 SQL 文件,勾选“创建数据库”“创建表”“创建外键”,保存为schema.sql - 使用
schemacrawler(免费开源)生成 HTML:schemacrawler -server=mysql -database=mydb -u user -p pass -host=localhost -port=3306 -command=schema -outputformat=html -outputfile=docs.html -schemas=myschema
(注意:需先在真实库中执行schema.sql,schemacrawler 读的是运行时元数据,不是 .sql 文件) - 若坚持离线处理(不连库),可用
sql2diagram或 Python 脚本解析schema.sql,但无法还原外键布局、注释、ER 关系图——只能生成纯文本结构树
导出 SQL 前必须检查的三个硬性条件
否则生成的 schema.sql 会缺字段、漏约束、外键失效,下游 HTML 文档直接失真:
-
Validate Model必须通过:右键画布 →Validate Model,解决所有Missing primary key、Foreign key references non-existent table类报错 - 模型属性中数据库版本必须与目标环境一致:比如连的是
MySQL 5.7,模型类型就不能设成MySQL 8.0,否则JSON字段会生成失败并静默跳过 - 所有表名/字段名若含
order、group等保留字,必须手动加反引号包裹,否则schema.sql执行报ERROR 1064,后续 HTML 生成工具读取失败
替代方案:用 Mermaid + 手动同步维持轻量交互文档
如果团队只需要可读性强、能版本管理、支持 Git Diff 的轻量文档,更现实的做法是:
- 在 Navicat 模型中完成设计后,用
右键表 → 复制为 DDL或导出为 SQL提取建表语句 - 人工整理成
mermaid erDiagram语法(例如:USERS ||--o{ ORDERS : "creates"),粘贴进 Markdown - 用 VS Code 插件
Mermaid Preview实时渲染,或用mermaid-cli导出 PNG/SVG 内嵌到 HTML - 优点:文本格式、可 Review、可 CI 自动更新;缺点:ER 布局需手调,不自动同步字段变更
真正的“交互式”体现在可点击跳转、字段搜索、表过滤——这些 Navicat 不做,也不打算做。你得接受一个事实:它的模型是设计资产,不是文档资产;想交付 HTML,就得自己搭桥,而且桥要从 SQL 这头开始修。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










