navicat报“私钥格式不兼容”基本是因使用.ppk文件，需用puttygen转为openssh格式（开头为-----begin openssh private key-----），并确保路径无中文空格、权限为600、协同时统一共享目录与相对路径。
Navicat 报“私钥格式不兼容”，基本就是碰上了 .ppk 文件——PuTTY 系列工具（比如 PuTTYgen）生成的私钥，Navicat 从 v15 起默认只认 OpenSSH 格式，.ppk 会被静默拒绝，连错误提示都可能不完整。
怎么判断是不是 .ppk 文件在作怪
打开你的私钥文件，用文本编辑器看开头几行：
- 如果是
-----BEGIN RSA PRIVATE KEY-----或-----BEGIN OPENSSH PRIVATE KEY-----→ 是 OpenSSH 格式，问题不在格式，而在路径、权限或 passphrase - 如果开头是
PuTTY-User-Key-File-2: ssh-rsa或根本是乱码（二进制）→ 铁定是.ppk，必须转换
别信文件后缀名，有些人手动把 .ppk 改成 .key，Navicat 还是读不了。
用 PuTTYgen 把 .ppk 转成 OpenSSH 私钥（Windows/macOS 都适用）
PuTTYgen 是最稳妥的转换工具，它能输出标准 PEM 格式，Navicat 和 OpenSSH 命令行都认：
- 启动 PuTTYgen，点击 Load，选中你的
.ppk文件 - 确认弹窗里显示的是你预期的密钥类型（如 RSA / Ed25519），且“Key comment”正确
- 点击菜单 Conversions → Export OpenSSH key (force new file format)（注意：选带
(force new file format)的那一项，避免旧版兼容问题） - 保存为
id_rsa或jump_key这类无空格、无中文、无特殊符号的纯英文名
生成的文件开头必须是 -----BEGIN OPENSSH PRIVATE KEY-----，不是 -----BEGIN RSA PRIVATE KEY----- 也没关系，Navicat v16+ 完全支持新格式。
Navicat 里填路径时最容易踩的三个坑
就算密钥转对了，Navicat 还可能因为路径细节失败，而且往往不报错，只“跳过 SSH 隧道”走直连：
-
~符号在 macOS 上无效，写~/keys/id_rsa会加载失败；必须写绝对路径，例如/Users/you/.ssh/jump_key - 路径含空格或中文（如
/Users/张三/.ssh/id_rsa或/Users/me/My Keys/id_rsa）→ Navicat 直接拒绝读取 - 文件权限太宽松：Mac/Linux 下执行
chmod 600 /path/to/jump_key，否则 OpenSSH 底层直接拒载，报bad permissions
建议把私钥统一放到 /Users/you/navicat-keys/（macOS）或 C:\navicat-keys\（Windows），路径干净，也方便团队共享时统一引用。
协同模式下私钥路径失效怎么办
Navicat Cloud 同步的只是连接配置里的路径字符串，不是密钥文件本身。你在 Mac 上配的 /Users/alice/.ssh/id_rsa，同步到同事 Windows 电脑上，路径自然不存在，Navicat 会静默跳过 SSH 设置，导致连接失败但不提醒。
- 团队共用一个共享目录（如 Git 仓库里的
./configs/ssh_keys/或网络盘映射的Z:\team-keys\） - 所有人把转换好的 OpenSSH 私钥复制进去，并重命名为统一名称（如
prod-jump.key） - Navicat 连接设置中填相对路径
./configs/ssh_keys/prod-jump.key（v16.1+ 支持）或绝对映射路径（如Z:\team-keys\prod-jump.key）
真正麻烦的从来不是“一次转好”，而是“十个人在三台系统上每次打开都走隧道”。路径一旦写死又没统一约定，不出三天就有人连错库。
