navicat 不支持命令行结构同步，因其纯 gui 设计且无 cli 或 api 接口；ci/cd 应改用 liquibase/flyway 等可版本化、可自动化方案。
Navicat 本身没有官方提供的命令行工具（navicat-cli 不存在），所谓“Navicat 命令行同步”是常见误解——它不支持无 GUI 的 headless 模式执行结构同步。CI/CD 流程中必须绕过 Navicat GUI，改用真正可脚本化的方案。
为什么不能直接调用 Navicat 执行结构同步？
Navicat 是纯图形界面应用，其 Windows/macOS/Linux 客户端均依赖 GUI 环境（如 X11、Cocoa、Win32 消息循环）。即使强行用 xvfb 或 headless 模拟显示，也无法触发「结构同步」向导的自动化执行逻辑；它的同步功能只暴露给用户点击操作，未提供 CLI 接口或 REST API。
你看到的“Navicat 命令行”相关教程，实际多为以下混淆：
- 误把
navicat.exe --help（仅启动参数）当作功能入口 - 把 Navicat Data Modeler 导出的 SQL 脚本当成“命令行输出”，但生成仍需手动点选
- 用 AutoHotkey / AppleScript 模拟鼠标点击——不可靠、难维护、CI 环境基本失效
CI/CD 中替代 Navicat 结构同步的可行路径
真实落地的方案必须满足：可版本控制、可重复执行、可 diff、可回滚、无交互。推荐组合如下：
-
用
mysqldump --no-data+diff做轻量级结构比对：适合小项目，但无法识别重命名、索引调整等语义变更 -
用
liquibase或flyway管理 DDL 版本：把每次表变更写成带编号的V1__add_user_table.sql，CI 中执行liquibase update -
用
pt-online-schema-change（Percona Toolkit）做线上 DDL：适用于大表变更，但需额外权限和 MySQL 配置支持 -
用
mysqlpump --exclude-databases+ 自定义解析脚本：导出结构后用 Python 解析 CREATE TABLE，生成差异 patch（较重，但可控）
注意：mysqldump --no-data 输出含 CREATE DATABASE 和字符集声明，对比前务必用 grep -v "^CREATE DATABASE" 过滤，否则跨环境比对总失败。
如果硬要保留 Navicat 工作流，只能折中导出再移交
开发人员在 Navicat GUI 中完成结构同步预览后，不点「运行查询」，而是点击右下角 保存为 SQL 文件 → 提交该 SQL 到 Git → CI 流程中用 mysql -h $HOST -u $USER -p$PASS db_name 执行。
这个流程的关键约束：
- SQL 文件必须人工审查：Navicat 生成的 DDL 可能含
DROP FOREIGN KEY `fk_123`但没给出原 constraint 名，导致在目标库执行报错 - 不能自动识别新增列的默认值是否已填充历史数据（MySQL 8.0.13+ 支持
ADD COLUMN ... DEFAULT原地加列，旧版会锁表） - Navicat 不生成降级脚本（
rollback），CI 中一旦失败，只能靠备份恢复，无法原子回退
真正的数据库即代码（Data-as-Code）实践里，Navicat 只应作为辅助设计工具，而非部署环节的执行者。它的同步按钮解决的是「人肉比对效率」问题，不是「自动化交付可靠性」问题——后者必须交给 Liquibase、Flyway 或自研 SQL pipeline 来兜底。
