不推荐直接用 .ndm 文件做跨 Win/Linux 的 Git 版本管理，因其为二进制内部格式，跨平台/跨版本兼容性差，Git 无法 diff 且易冲突；应导出为 UTF-8 编码的 SQL 和 XMI 2.1 文本文件进行 Git 管理，并严格遵循路径、命名及导入规范。
Navicat .ndm 文件在跨平台 Git 管理中是否可靠
不推荐直接用 .ndm 文件做跨 win/linux 的 git 版本管理。它本质是二进制封装格式，不同 navicat 版本（尤其是 windows 和 linux 客户端）生成的 .ndm 文件结构不一致，git 无法 diff，合并时必然冲突，且恢复失败率极高。
常见错误现象：git checkout 后 Navicat Linux 版打不开 Windows 导出的 .ndm，报错 "Invalid model file format" 或直接闪退；或打开后字段顺序错乱、关系线丢失。
- Navicat 官方文档明确标注
.ndm为“内部格式”，未承诺跨平台/跨版本兼容 - Linux 版 Navicat（基于 Qt）对 Windows 生成的元数据编码（如路径分隔符、换行符、BOM）处理更敏感
- 即使同版本，Win 上保存的
.ndm在 Linux 上重新打开再保存，文件哈希值也会变——Git 误判为“已修改”
替代方案：导出为可 diff 的文本格式再 Git 管理
必须放弃 .ndm，改用 Navicat Data Modeler 内置的导出功能生成标准文本，才能实现 Win/Linux 双端协同。
- 导出路径：菜单栏
File → Export → To SQL File，选MySQL/PostgreSQL等目标 DBMS，勾选Include CREATE TABLE、Include Foreign Keys、Include Comments - 同时导出
File → Export → To XML (XMI)，选XMI 2.1标准——这是唯一被 Git 友好支持的模型交换格式，能清晰展示实体、属性、关系的层级结构 - SQL 文件用于物理验证（可直接导入本地数据库），XMI 文件用于逻辑比对（
git diff能看出谁删了哪个字段） - 所有导出文件统一用 UTF-8 编码保存，禁用 BOM（Navicat 导出默认无 BOM，但某些编辑器会偷偷加）
Git 仓库结构与协作规范
结构混乱是跨平台模型协同失效的主因。必须约定根目录下固定子路径，否则 Win/Linux 路径大小写、分隔符差异会破坏引用。
- 根目录放
VERSION文件（纯文本，内容如v1.2.0-20260422），每次模型变更后更新并git tag绑定 - 模型文件存于
/models/下，强制小写命名：user_auth.xmi、user_auth.sql，禁用空格和中文 -
.gitignore必须包含：*.ndm、*.bak、Thumbs.db、.DS_Store（Linux 拉取 Win 提交时可能带入） - 禁止直接在 Navicat 里“保存模型”，所有变更必须走“导出 → 提交 → 同步 → 重新导入”闭环
Linux 端导入 XMI/SQL 的实操要点
Linux 版 Navicat 对导入路径和权限更严格，容易卡在第一步。
- 导入 XMI：菜单
File → Import → From XML (XMI)，必须点开“Advanced Options”，勾选Overwrite existing objects，否则只追加不覆盖 - 导入 SQL：右键目标连接 →
Execute SQL File，编码务必手动选UTF-8（Linux 默认可能为ISO-8859-1，导致注释乱码、建表失败） - 若 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';核对表数量，避免因外键顺序问题导致部分表没建成功
最常被忽略的是：Navicat Linux 版不读取 Windows 用户目录下的配置缓存，每次导入 XMI 后，必须手动点击 Model → Validate Model 才能刷新关系图——不点这一步，ER 图里连线全消失，但底层 SQL 实际已生效。
