Win/Linux Navicat数据模型同步，导出ndm文件用Git版本管理

先说一个核心结论：千万别拿 .ndm 文件直接往 Git 里扔，尤其是在 Windows 和 Linux 之间来回折腾。它本质上就是个二进制黑箱，不同版本的 Na vicat（特别是跨平台）生成的结构压根不对齐。Git 没法做 diff，合并时冲突是板上钉钉的事，恢复成功的概率低得可怜——这不是技术问题，是设计上的硬伤。

常见翻车现场：从 Windows 导出的 .ndm，用 git checkout 拉到 Linux 版 Na vicat 里，要么弹窗报 "Invalid model file format"，要么直接闪退；偶尔能打开，字段顺序却乱成一团，关系线凭空消失。背后的原因其实很明确——

• Na vicat 官方文档白纸黑字写着 .ndm 是“内部格式”，从没承诺过跨平台或跨版本兼容。
• Linux 版 Na vicat 基于 Qt 构建，对 Windows 那边生成的元数据编码（比如路径分隔符、换行符、BOM）异常敏感，稍有偏差就罢工。
• 就算两边的 Na vicat 是同一个版本，Windows 保存的 .ndm 在 Linux 上打开再保存一次，文件哈希值也会变——Git 会误以为文件被修改过，平添一堆无意义的提交记录。

替代方案：导出为可 diff 的文本格式再 Git 管理

既然二进制路走不通，那就转向 Na vicat Data Modeler 内置的导出功能，生成标准文本文件，这才是 Win/Linux 双端协同的正确姿势。

• 导出路径：菜单栏 File → Export → To SQL File，选择对应的 DBMS（MySQL、PostgreSQL 等），务必勾选 Include CREATE TABLE、Include Foreign Keys、Include Comments。
• 同时再导一份 File → Export → To XML (XMI)，选 XMI 2.1 标准——这是目前唯一能被 Git 友好支持的模型交换格式，实体、属性、关系的层级结构一目了然。
• SQL 文件用于物理验证，拿到就能直接导入本地数据库跑一遍；XMI 文件用于逻辑比对，git diff 能清晰看出谁删了哪个字段、改了哪个关系。
• 所有导出文件统一用 UTF-8 编码保存，并且禁用 BOM。默认导出是无 BOM 的，但有些编辑器会偷偷加上，一旦出现，Linux 端就可能出问题。

Git 仓库结构与协作规范

跨平台模型协同失败的另一个常见原因是仓库结构混乱。必须约定根目录下的固定子路径，否则 Windows 和 Linux 在路径大小写、分隔符上的差异会直接破坏引用。

• 根目录放一个 VERSION 文件（纯文本，内容如 v1.2.0-20260422），每次模型变更后更新并绑定 git tag。
• 模型文件全部存于 /models/ 下，强制小写命名：user_auth.xmi、user_auth.sql，禁用空格和中文。
• .gitignore 必须包含：*.ndm、*.bak、Thumbs.db、.DS_Store（Linux 拉取 Windows 提交时很可能带进来）。
• 禁止直接在 Na vicat 里“保存模型”——所有变更必须走“导出 → 提交 → 同步 → 重新导入”这个闭环，一步都不能省。

Linux 端导入 XMI/SQL 的实操要点

Linux 版 Na vicat 对导入路径和权限要求更苛刻，最容易卡在第一步。

• 导入 XMI：菜单 File → Import → From XML (XMI)，记得点开 Advanced Options，勾选 Overwrite existing objects，否则只追加不覆盖，多次导入后模型里会出现一堆重复对象。
• 导入 SQL：右键目标连接 → Execute SQL File，编码务必手动选 UTF-8。Linux 默认可能是 ISO-8859-1，用这个编码导入 UTF-8 的 SQL，注释乱码、建表失败几乎是必然的。
• 如果 SQL 导入时报 "Unknown character set: 'utf8mb4'"，说明导出时用了 MySQL 8.0+ 的特性，而你的本地 MySQL 是 5.7。解决方案：在导出向导中取消勾选 Use utf8mb4，或者手动替换 SQL 中所有 utf8mb4 为 utf8。
• 导入后务必跑一遍 SELECT COUNT(*) FROM information_schema.TABLES WHERE TABLE_SCHEMA = 'your_db'; 核对表数量。外键顺序问题很容易导致部分表建不出来，但 Na vicat 不会报错。

还有一个极容易被忽略的细节：Na vicat Linux 版不读取 Windows 用户目录下的配置缓存，每次导入 XMI 后，必须手动点击 Model → Validate Model 才能刷新关系图。不点这一步，ER 图里所有连线都会消失——但底层 SQL 其实已经生效了。别再被这个假象误导了。