Navicat 15可视化导出表结构文档：使用导出向导生成HTML

用 Na vicat 15 导出表结构，如果目标是生成一份带字段注释的单表 HTML 文档，那核心路径只有一个：右键点击表，选择“导出向导”，然后勾选“仅结构”。

千万别图省事去点“打印”或者“数据库字典”，这两条路都走不通，拿不到你想要的那种干净、聚焦的字段级 HTML 文件。

为什么“导出向导”才是正解，而不是“数据库字典”？

“数据库字典”功能很好，它的定位是生成整个数据库的汇总文档，包含所有表、索引、外键信息，适合做全面的架构手册。但如果你只需要给前端同事或测试人员看一张核心表的具体字段定义，那它就显得“大而全”了，字段注释往往被折叠在二级列表里，找起来不方便。

反观“导出向导”，它就在右键菜单里，一步直达。最关键的是，它提供了非常细颗粒度的控制选项：

• 勾选 「仅结构」：确保只导出表定义，不包含任何数据。
• 勾选 「包含注释」：这是重中之重，少了它，字段的 COLUMN_COMMENT 就为空。
• 勾选 「包含索引」：如果还需要展示主键、唯一约束等信息，记得勾上。

这样生成的 HTML 文件，每一列都清晰对应着 COLUMN_NAME、COLUMN_TYPE、COLUMN_COMMENT 这些元数据，一目了然。

常见的一些“坑”也值得注意：

• 点了“打印”：弹出一个预览窗口，但没法保存成文件。
• 在表结构页点“DDL”标签：复制出来的是一段 SQL 建表语句，不是可读的表格。
• 用“工具→数据库字典”：导出的内容太泛，单表字段注释被藏起来了，阅读体验不佳。

这个场景很明确：给前端/测试人员提供某张核心表的字段说明，需要带中文注释、类型、约束，并且要能直接双击打开，在浏览器里搜索字段名。所以，导出格式选 HTML 是最佳选择，它支持搜索、缩放，并且 Na vicat 生成的 HTML 是单文件，没有外部依赖，分享起来特别方便。

导出后中文乱码？问题出在编码设置没对齐

很多朋友会遇到打开 HTML 文件后，字段名或注释变成方块或问号。这通常不是浏览器的问题，而是编码没对齐。Na vicat 15 的 HTML 导出本身不强制控制页面编码，它依赖于连接层的字符集和导出对话框里的编码选择。

解决起来分两步：

• 第一步：检查连接字符集。 右键连接 ->「编辑连接」->「高级」选项卡，确认「字符集」设置正确。MySQL 建议设为 utf8mb4，PostgreSQL 设为 UTF8。
• 第二步：手动指定导出编码。 在导出向导的最后一步（“导出设置”页），找到「编码」下拉框，手动选择 UTF-8。不要用系统默认的 locale 编码，这一步很容易被忽略。

验证方法也简单：用文本编辑器打开生成的 HTML 文件，搜索 ，确认值是 "UTF-8"。如果不是，那说明第二步没生效。

导出的 HTML 打开是白屏？换个浏览器，别用 Chrome 直接双击

Na vicat 15 生成的 HTML 文件里嵌入了 Ja vaScript 脚本，用于实现字段折叠、搜索、排序等功能。但 Chrome 和 Edge 出于安全考虑，默认禁止 file:// 协议下的脚本执行，导致页面加载后卡死，只剩一个空白的标题栏。

正确的打开方式有以下几种：

• 首选 Firefox： 双击打开，原生支持本地 JS，体验最好。
• 搭建本地 Web 服务： 把 HTML 文件扔进一个本地 Web 服务目录（比如在文件所在目录运行 python -m http.server 8000），然后通过 http://localhost:8000/report.html 访问。
• 使用 Safari： 需要先在偏好设置 -> 安全性中，勾选「允许从文件下载的脚本」。

有几个“坑”千万别踩：

• 不要试图用 VS Code 的 Live Server 插件打开，它可能会额外添加响应头，干扰 Na vicat 写死的 JS 路径。
• 不要手动删除 HTML 里的 标签，否则所有交互功能都会丢失，只剩一个静态表格。

想批量导出多张表的结构 HTML？这条路走不通，得换方案

需要说明的是，Na vicat 15 的右键“导出向导”不支持批量操作。一次只能选定一张表导出。虽然你可以多选表再右键，但它实际是并行启动多个导出任务，每个任务生成一个独立的 HTML 文件，没办法统一命名或合并成一个文件。

如果需要批量导出，可以考虑以下替代方案：

• 手写 SQL 查询： 查询 INFORMATION_SCHEMA.COLUMNS 表，拼接出所有表的结构数据，再借助其他工具或脚本导出为 HTML。这种方式格式可控，但需要你懂点 SQL。
• 命令行工具： 用 ncli 执行查询，输出为 CSV，再用 Python 脚本转换成 HTML。适合需要定时生成文档的场景。

有一点需要注意：如果强行把多张表的结构混在一个 HTML 里，Na vicat 不会自动生成锚点跳转，需要自己手动补上 这样的标签。另外，如果表名包含空格或特殊字符，导出的文件名可能会被截断，建议提前重命名表或用英文别名。

说到底，这件事的难点不在于操作步骤本身，而在于每个环节的细节——编码对不对、协议兼容性如何、浏览器选哪个。只要把这些细节都对齐了，生成的文档才能被其他人顺利打开和使用。