Navicat 16升级到17后连接全空是格式不兼容所致，非bug；必须用v16导出.ncx文件、v17导入，不可直接复制配置目录，且导入后需重输密码、重设SSH路径、校正UTF-8编码。
Navicat 16升级到17后连接全空，不是bug是格式不兼容
navicat 17不会自动识别或升级connections.ncx文件结构，直接复制旧版配置目录（比如~/library/application support/premiumsoft/navicat/下的文件）会导致界面正常但双击连接无反应——控制台不报错，也测不通，极难定位。
- 官方未提供转换工具，
Connections.ncx在v16和v17之间存在底层字段变更（如加密标识、时间戳格式、SSH配置嵌套层级） - 别尝试手动编辑XML：v17解析器对节点顺序、空格、命名空间更严格，轻微格式错误就会静默跳过整条连接
- 最稳路径是“导出→清理→导入”：用v16导出
.ncx文件，再在v17中导入，而非拷文件夹
macOS上v16和v17的配置路径完全不同，硬拷会失败
macOS版Navicat 16和17采用完全隔离的沙盒路径，直接复制Application Support下内容会因权限、容器签名、plist绑定失效而被系统拦截或忽略。
- v16路径：
~/Library/Application Support/PremiumSoft/Navicat/ - v17路径：
~/Library/Containers/com.navicat.NavicatPremium/Data/Library/Application Support/PremiumSoft CyberTech/Navicat CC/Common/（注意中间多了Containers和Data两级） - 即使你把v16的
conn.plist、pref.plist复制过去，v17启动时也会因Bundle ID不匹配拒绝加载 - 实操唯一可行方案：在v16里菜单 → 工具 → 导出连接 → 勾选
Include password→ 保存为export.ncx；v17中菜单 → 文件 → 导入连接 → 选该文件
导入后密码为空、SSH密钥路径失效、中文名乱码
导出的.ncx文件本身不含密码明文（v16/v17均加密），且路径、编码、运行时依赖全部绑定原环境，必须逐项重配。
- 密码字段显示星号≠已保存：每个连接都需双击打开 → 切换到「常规」页 → 手动输入密码 → 勾选
Save password→ 点Test Connection - SSH私钥路径必然失效：macOS的
~/.ssh/id_rsa在v17沙盒内不可见，必须改用绝对路径（如/Users/xxx/.ssh/id_rsa）并确认文件权限为600 - 中文连接名乱码？v16导出默认用UTF-8，但v17在某些macOS系统版本下读取时可能误判为GBK——用VS Code打开
export.ncx，右下角确认编码为UTF-8 without BOM，换行符设为LF，再保存重导入
Navicat Cloud同步不能替代本地迁移
哪怕你两边都登录了同一账号，只要没主动开启对应同步项，连接列表就不会更新。云同步不是自动镜像，而是按需拉取。
- 检查右下角状态栏是否显示
Synced（不是Syncing…或空白） - 网页端
Navicat Cloud Portal中，确认Connections和Queries开关已启用 - macOS用户若用Apple ID登录系统，Navicat可能卡在系统级凭据层——设置里先
Sign out，重启App，再重新登录Navicat账号 - 但注意：免费账户最多同步2台设备，第三台会自动踢掉最早的一台，导致“刚同步完就断连”
.ncx导出/导入是唯一可控路径；任何绕过这步的操作，后续大概率要花3倍时间排查静默失败。
