Navicat 15 必须用「右键表→导出向导→仅结构」导出带字段注释的单表HTML，因“数据库字典”生成全库汇总页、字段注释被折叠，而导出向导支持勾选“仅结构”“包含注释”等细粒度控制，生成含COLUMN_NAME、COLUMN_TYPE、COLUMN_COMMENT的可读HTML单文件。
navicat 15 可视化导出表结构为 html 文档，必须用「右键表 → 导出向导 → 仅结构」路径，不能点“打印”或“数据库字典”，否则得不到带字段级注释的单表 html。
为什么右键导出向导比“数据库字典”更合适
“数据库字典”导出的是全库汇总页（含所有表+索引+外键），适合做整体文档；而单表结构文档需要聚焦字段定义、注释、是否为空、默认值等细节。“导出向导”在右键菜单里直接可达，且支持勾选「仅结构」「包含注释」「包含索引」等细粒度控制，生成的 HTML 表格每列都对应 COLUMN_NAME、COLUMN_TYPE、COLUMN_COMMENT 等真实元数据字段。
常见错误现象：
— 点了“打印”→ 弹出预览窗口，无法保存文件
— 在表结构页点“DDL”标签 → 复制出来是 SQL，不是可读 HTML
— 用“工具→数据库字典”→ 导出内容太泛，单表字段注释被折叠进二级列表，不易查阅
- 适用场景：给前端/测试提供某张核心表的字段说明，需带中文注释、类型、约束，且要求能直接双击打开、搜索字段名
- 导出格式必须选 HTML（不是 PDF 或 Excel）：HTML 支持浏览器内搜索、点击跳转、缩放清晰，且 Navicat 生成的 HTML 是单文件，无外部依赖
- 关键勾选项：务必勾选「仅结构」（否则会导出数据）、「包含注释」（否则
COLUMN_COMMENT为空）、「包含索引」（如需展示主键/唯一约束）
导出后中文乱码？检查这两处编码设置
Navicat 15 的 HTML 导出本身不控制页面编码，它依赖连接层字符集 + 导出对话框里的显式编码选择。如果打开 HTML 后字段名或注释显示为方块或问号，不是浏览器问题，而是编码没对齐。
- 第一步：右键连接 →「编辑连接」→「高级」选项卡 → 确认「字符集」设为
utf8mb4（MySQL）或UTF8（PostgreSQL） - 第二步：在导出向导最后一步（“导出设置”页），找到「编码」下拉框 → 手动选
UTF-8（不要用默认的系统 locale） - 验证方式：导出后用文本编辑器打开 HTML 文件，搜索
<meta charset=，确认值是"UTF-8"；如果不是，说明第二步没生效
导出的 HTML 打开是白屏？别用 Chrome 直接双击
Navicat 15 生成的 HTML 带内联 JavaScript（用于折叠字段、高亮搜索、表格排序），Chrome 和 Edge 默认禁止 file:// 协议下的脚本执行，导致页面加载卡死、只显示标题栏。
立即学习“前端免费学习笔记（深入）”；
- 正确打开方式：
— 用 Firefox 双击打开（原生支持本地 JS）
— 或把 HTML 文件扔进本地 Web 服务目录（如 Python 的python -m http.server 8000），再访问http://localhost:8000/report.html
— 或改用 Safari（需在「偏好设置→安全性」中勾选「允许从文件下载的脚本」） - 别踩的坑：
— 不要试图用 VS Code Live Server 插件打开：它会加额外响应头，可能干扰 Navicat 写死的 JS 路径
— 不要手动删 HTML 里的<script>标签：功能全失，只剩静态表格
想批量导出多张表的结构 HTML？得换路子
Navicat 15 的右键「导出向导」不支持多表同时触发 HTML 导出（一次只能选一张表）。你看到的“多选表 → 右键 → 导出向导”实际是并行启动多个导出任务，无法统一命名或合并成一个 HTML。
- 替代方案：
— 用 SQL 查询INFORMATION_SCHEMA.COLUMNS拼出所有表结构，再导出为 HTML（格式可控，但需手写 SQL）
— 或走命令行：用ncli执行查询输出 CSV，再用 Python 脚本转 HTML（适合定时生成） - 注意点：
— 多表结构混在一个 HTML 里时，Navicat 不会自动加锚点跳转，得靠脚本补<a name="table_user">
— 如果表名含空格或特殊字符，导出的 HTML 文件名可能被截断，建议提前重命名表或用英文别名
真正麻烦的不是操作步骤，而是每个环节的编码和协议细节——连对一个 UTF-8，选对一个浏览器，都直接影响文档能不能被别人正常打开。
