Navicat结构同步需确保源库与目标库类型一致，否则DDL解析失败；必须手动点击“对比”按钮生成有效.ncx文件；默认忽略字段注释和排序规则差异，需手动勾选对应选项；命令行执行不生成HTML报告。
结构同步窗口里选错数据库类型会直接失败
navicat 的结构同步功能不校验源库和目标库是否同类型，但实际执行时会报错——比如拿 mysql 当 postgresql 用，对比按钮点下去后状态栏可能只显示“processing…”卡住，或弹出 unsupported data type in target database 这类错误。必须确保两个连接配置中选择的数据库类型与真实后端一致（例如 postgresql 连接不能选成 mysql 类型），否则 ddl 解析阶段就崩了。
实操建议：
- 右键连接名 →
编辑连接→ 确认“连接类型”下拉框选对了（MySQL / PostgreSQL / SQLite 等） - 如果源是达梦或 OceanBase，必须用 Navicat Premium 16+，且连接类型要选对应国产库选项，不能强行套用 MySQL 模式
- SQLite 作为目标库时，不支持视图、存储过程等对象，勾选“要创建的对象”列表里出现这些项，点击
下一步会直接报错，得手动取消
对比前必须手动触发“比较”，否则.ncx导出为空
很多人导出 .ncx 文件后用命令行跑定时任务，结果发现每次都没差异——根本原因是没真正执行过对比。Navicat 的结构同步界面默认只是加载连接，不自动比对；只有点击右下角 对比 按钮后，状态栏才会显示 Differences found 或 No differences，这时导出的 .ncx 才包含有效差异信息。
容易踩的坑：
- 直接右键标签页 →
导出任务，没点对比就保存，生成的 .ncx 文件在命令行里运行会提示No comparison result found - 对比完成后没留意状态栏文字，误以为已生效，其实只是加载了元数据，还没计算差异
- 跨云数据库（如阿里云 RDS 和本地 MySQL）对比时，网络延迟可能导致
对比按钮响应慢，需等状态栏明确更新再操作
字段注释和排序规则差异默认不参与对比
Navicat 默认忽略 column comments 和 collation 差异，即使两个表字段名、类型都一样，仅注释不同，也会标为“没有操作”。这在 dev/test 环境同步时容易漏判关键语义变更。
解决方法很直接：
- 点击
对比后，在右侧选项面板勾选Compare column comments和Compare collation - PostgreSQL 用户注意：排序规则（collation）对比仅在 Navicat Premium 17+ 支持，旧版本勾了也无效
- MySQL 8.0+ 的
utf8mb4_0900_as_cs和utf8mb4_unicode_ci被视为不同 collation，勾选后会触发 ALTER TABLE 修改，务必确认目标库字符集兼容
命令行跑 .ncx 任务时无法生成 HTML 报告
navicat.exe -runjob xxx.ncx 只执行同步动作，不会弹窗、不生成 HTML 差异报告——这是设计限制，不是 bug。想留档或发给同事看，必须额外加脚本处理。
可行路径：
- 先用 GUI 手动对比一次，点
保存报告→ 输出 HTML，存为模板文件 - 写个 PowerShell 脚本，在
-runjob前先用curl或Invoke-WebRequest调用 Navicat 内置 HTTP 接口（需开启“启用 HTTP 服务”选项）抓取当前对比快照 - 更稳妥的做法：把
部署脚本选项卡里的 SQL 导出为.sql文件，用git diff做文本级比对，天然带版本和可读性
真正麻烦的从来不是点几下鼠标，而是当两个环境字段数超两百、索引命名不规范、又混着大小写敏感时，对比 按钮背后跑的那几秒，到底在解析什么、忽略什么、又悄悄改了什么——这些细节不翻日志根本看不见。
