navicat 不支持跨平台自动文档生成，因其模型打印和导出功能依赖本地渲染引擎导致输出不一致；可行方案是查询 information_schema 元数据并用通用工具二次处理。
navicat 本身不支持跨平台自动文档生成——它的「模型打印」和「导出为 word/pdf」功能严重依赖本地渲染引擎（macos 用 qt+cups，windows 用 gdi+com），同一份操作在不同系统上输出效果不一致，甚至中文错乱、表格错位。真正可行的跨平台自动化路径只有一条：绕过 gui 渲染，直接查 information_schema 元数据，导出结构化文本，再用通用工具二次处理。
为什么不能直接用 Navicat 的「模型 → 打印」功能
该功能本质是截图式渲染，不是数据导出：
• macOS 导出的 PDF 在 Windows 上打开常出现文字截断、行高异常；
• HTML 导出默认无 <meta charset="UTF-8">，浏览器按 ISO-8859-1 解析，中文全变方块或问号；
• Word 导出在非 Windows 系统上不可用（调用 COM 接口失败）或格式崩坏（WPS 兼容性差）；
• 所有这些输出都不带表间关系、索引详情、外键约束等关键设计信息，只是静态快照。
用 SQL 查询 + 导出 CSV/Excel 实现稳定跨平台
这是目前最轻量、兼容性最强的方案，所有平台上的 Navicat 都能执行且结果一致：
• 必须显式指定 TABLE_SCHEMA = 'your_db_name'，否则会混入 information_schema、mysql 等系统库字段；
• 排序必须用 ORDINAL_POSITION，而非 COLUMN_NAME，否则不同版本 MySQL 返回列序可能错乱；
• 中文备注字段 COLUMN_COMMENT 在导出时需勾选「UTF-8 with BOM」编码，否则 Excel（尤其 Windows 版）打开即乱码；
• 若字段备注含换行符，导出格式优先选 CSV 并启用「使用引号包围字段内容」，避免 Excel 解析错行。
最小可用查询示例：
SELECT TABLE_NAME AS `表名`, COLUMN_NAME AS `字段名`, COLUMN_TYPE AS `数据类型`, IS_NULLABLE AS `是否为空`, COLUMN_DEFAULT AS `默认值`, COLUMN_COMMENT AS `备注` FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = 'your_db_name' ORDER BY TABLE_NAME, ORDINAL_POSITION;
导出后如何批量转成可交付文档
Navicat 不提供导出前钩子或模板引擎，所以“自动化”发生在导出之后：
• HTML：用 VS Code 打开导出文件，在 第一行手动插入 <meta charset="UTF-8"> 即可修复中文；
• PDF：不要用 Navicat 自带 PDF 导出，而是将 CSV 用 LibreOffice Calc 打开（跨平台一致），调整列宽、冻结首行，再统一导出为 PDF；
• Word：推荐用 Python + python-docx 脚本读取 CSV，按表分节生成带标题、表格、样式的设计文档——这样能控制字体、缩进、超链接等细节，且脚本可 Git 版本化；
• 注意：若数据库含上百张表，单页 HTML 或 Word 容易卡顿，建议按模块拆分为多个文件，用目录页索引。
跨平台真正的难点不在“怎么导出”，而在于“谁来保证每次导出的语义一致”——比如 COLUMN_TYPE 在 MySQL 5.7 和 8.0 中返回格式不同（datetime vs datetime(0)），COLUMN_COMMENT 在低版本可能为空。这些细节不会报错，但会让文档可信度打折扣。务必在首次生成后人工抽检 3–5 张典型表，确认字段顺序、注释完整性、空值标识是否与实际 DDL 严格匹配。
