Navicat结构同步在Windows和macOS上功能可用但存在关键差异：启动方式、路径处理、字符集校对规则解析、SQL生成逻辑及对象过滤机制均不同，需针对性调整操作流程。
navicat 的结构同步功能在 windows 和 macos 上能用，但默认行为、路径处理和 sql 生成逻辑有实质性差异，直接照搬同一套操作流程大概率导致比对失败或脚本执行异常。
Windows 与 macOS 下结构同步的启动方式不同
Windows 版点击 工具 → 结构同步 即可进入向导；macOS 版必须先建立一个有效的数据库连接（哪怕只是测试连通性），否则 结构同步 菜单项是灰色不可点状态。这不是 Bug，是 macOS 版 Electron 架构下对上下文依赖更强的表现。
常见错误现象：结构同步 菜单不可用、点击无响应、弹出空窗口。
- Windows：可直接通过
navicat.exe --connect "MyDB"命令行预加载连接 - macOS：不支持命令行指定连接，必须手动连一次；且连接名中若含空格或中文，后续比对可能静默跳过部分表
- 两者都要求源库和目标库已成功连接并能展开对象树——如果某个库显示“连接失败”但图标仍是绿色，实际仍会卡在比对阶段
结构比对时的字符集与校对规则处理差异
macOS 版 Navicat 默认读取系统 locale 设置来推断字符集，而 Windows 版更倾向继承连接属性里的 charset 配置。当源库是 utf8mb4_0900_as_cs、目标库是 utf8mb4_general_ci 时，Windows 版可能跳过校对规则比对，macOS 版则大概率报错 ERROR 1253 (42000): COLLATION 'utf8mb4_0900_as_cs' is not valid for CHARACTER SET 'utf8mb4'。
实操建议：
- 比对前统一关闭
Compare collation（在 Options 中）——除非你确认两端 MySQL 版本 ≥ 8.0.1 且引擎一致 - 避免在 macOS 上使用含中文路径的临时数据库（如
~/Desktop/测试库/），Navicat 内部解析会截断或乱码，导致比对对象缺失 - 若目标库为旧版 MySQL（如 5.7），务必取消勾选
Compare comments，否则生成的COMMENT语句无法执行
生成差异 SQL 后不能直接复制粘贴就完事
Navicat 生成的部署脚本不是“拿来即用”的纯 SQL，而是带执行顺序控制的复合脚本。macOS 版默认启用 Execute in chunks（分块执行），即使你只勾选了 3 张表，它也可能把 ALTER TABLE 和 DROP FOREIGN KEY 拆到不同块里，造成外键约束冲突；Windows 版则默认整块提交，更容易触发 ERROR 1845 (HY000)。
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
关键动作：
- 无论哪一端，都应先勾选
Compare foreign keys，确保外键定义被纳入比对范围 - 点击
部署脚本后，不要直接点运行，先点复制到剪贴板，再粘贴到新查询窗口手动调整顺序：先删外键、再改字段、最后加外键 - macOS 用户注意：复制出来的 SQL 可能末尾多出不可见的
\u200b（零宽空格），粘贴到终端或远程执行前需用编辑器清除
跨平台同步时最容易被忽略的权限与对象过滤问题
Windows 用户习惯右键批量选择表后点同步，macOS 用户常发现右键菜单里没有“全选”选项，只能逐个展开 Source Objects 树手动勾选——这导致日志表（log_*）、临时表（*_tmp）极易被误同步上生产环境。
没有正则过滤，也没有“排除模式”配置项。唯一可靠做法是：
- 在结构比对界面左侧的
Source Objects区域，逐级展开数据库 → 表 → 找到命名含backup、temp、test的表，右键 →Exclude from synchronization - 排除后该表所有变更（包括新增字段、类型修改）都不会出现在脚本中——不是“跳过变更”，而是彻底忽略这个对象
- 若目标库已有同名存储过程但逻辑不同，Navicat 不会提示覆盖风险，必须提前手动导出原定义备份，否则一键运行等于直接覆盖
跨平台同步真正的难点不在按钮位置，而在于 macOS 对路径、编码、空格的敏感度远高于 Windows，且错误反馈极其安静——它不报错，只是不做。所以每次比对后，务必点 重新比对 确认对象数量是否与预期一致，别只看“无差异”就关掉窗口。
