navicat 17 不支持在线协作文档，但可通过「工具 → 数据库字典」导出含超链接与搜索功能的utf-8编码html字典；需勾选表结构、索引、外键，且注释须数据库原生命令写入，导出后应通过本地服务器（如python3 -m http.server）打开。
Navicat 17 自身不支持直接生成可协作编辑的在线文档（如 Google Docs 或 Notion），但能导出结构清晰、带超链接和搜索功能的 HTML 数据字典，这是团队共享最实用、最稳定的方案。
用「工具 → 数据库字典」导出 HTML 是首选路径
这个功能专为共享设计，不是右键菜单里的“导出”或“转储 SQL”，入口藏在顶部菜单栏：选中数据库 → 工具 → 数据库字典 → 点击导出。关键设置必须手动确认：
- 勾选
包含表结构、包含索引、包含外键——漏掉任一选项，字典就缺关键约束信息 - 格式选
HTML，别选 PDF：PDF 无法复制字段名、无跳转链接、不支持浏览器内搜索 - 编码必须设为
UTF-8：导出对话框底部有独立下拉框，不能留空或选“系统默认”，否则中文注释变乱码 - 导出前检查连接属性：右键连接 →
编辑连接→SSH/SSL标签页 →字符集设为utf8mb4
导出后 HTML 打不开？不是文件坏了，是浏览器策略问题
Navicat 导出的 HTML 含内联 JavaScript，用于折叠表、点击跳转、实时搜索。Chrome 和 Edge 默认禁用本地 file:// 协议下的脚本，导致页面白屏或只显示标题。
- 正确打开方式：终端执行
python3 -m http.server 8000，然后浏览器访问http://localhost:8000/your_dict.html - 临时替代：用 Firefox 打开（对本地 file 协议更宽松，但新版也逐步收紧）
- 别双击直接打开，也别拖进浏览器地址栏——这两条路径必然失败
字段注释没显示？先验证注释是否真存在
Navicat 只读取数据库原生存储的注释，不识别界面里随便填的备注。不同数据库写法严格：
- MySQL：列注释必须用
COMMENT 'xxx'显式声明，例如ALTER TABLE user MODIFY COLUMN name VARCHAR(50) COMMENT '用户真实姓名'; - PostgreSQL：必须用
COMMENT ON COLUMN xxx IS 'yyy';，且需用psql或 Navicat 查询窗口执行，pgAdmin 写的有时不生效 - 导出前点
SQL 预览按钮：如果建表语句里没有COMMENT字段，说明注释根本没写对位置或权限不足 - Oracle 用户注意：
COMMENT ON COLUMN支持不稳定，常漏字段级注释，建议优先用COMMENT ON TABLE+ 文档补充
真正容易被忽略的是：HTML 字典里字段类型显示为 varchar(255) 并不等于实际类型错了——那是 Navicat 的简化映射，真实类型藏在 title 属性里（hover 就能看到）。团队成员第一次看时，得提醒他们把鼠标悬停上去看全貌。
