SSH认证失败导致GitHub拒绝访问,需依次验证ssh-agent加载、私钥权限、config路径、公钥完整性及仓库权限。

直接结论:不是 Git 报错,是 SSH 认证链断了——GitHub 根本没认出你是谁,得一层层验过去。
ssh -T git@github.com 返回 Permission denied (publickey)
这是最核心的诊断命令,别跳过它。输出这个错误,说明 SSH 连接连认证环节都没进,后面所有 git clone、git push 都会失败。
按顺序检查以下几点:
-
ssh-add -l是否列出你的私钥?没输出 = 没加载成功 - 是否执行过
eval "$(ssh-agent -s)"?Windows 用户注意:Git Bash、PowerShell、VS Code 内置终端三者 agent 不互通 - 私钥文件权限是不是
600?运行chmod 600 ~/.ssh/id_ed25519(别改.pub文件) -
~/.ssh/config里IdentityFile路径是否写对?后缀误写成.pub、或用了$HOME变量(SSH 不解析)都会失效 - 公钥内容是否完整复制?
cat ~/.ssh/id_ed25519.pub必须是一整行,开头是ssh-ed25519,结尾是你邮箱,不能有多余空格或换行
git push 报 remote: Permission to user/repo.git denied to xxx
恭喜,SSH 认证通过了,但你没仓库写权限。这类错误和密钥无关,别再反复配 key。
git-cliff 使用约定式提交和正则表达式驱动的自定义解析器从 Git 历史记录中生成变更日志文件。该工具使用 Rust 编写,通过 TOML 配置文件提供高度可定制的模板,并集成了 GitHub Actions、Docker 和 CI/CD 流水线。
先确认当前 remote 地址:git remote get-url origin,然后对照排查:
- 如果是推到自己 fork 的仓库,但
remote还指向上游(如facebookresearch/detectron2),那就是地址设错了,该改成你自己的:git remote set-url origin git@github.com:yourname/detectron2.git - 如果是私有仓库,去 GitHub/GitLab 页面点
Settings → Collaborators / Members,确认你账号被授予write或更高权限 - HTTPS 方式下,系统凭据可能缓存了旧账号:macOS 查
Keychain Access,Windows 打开Credential Manager,删掉对应 host 的记录
子模块报 Permission denied (publickey),但主仓库正常
因为 .gitmodules 文件里硬编码了 SSH 地址,比如 url = git@github.com:org/subrepo.git。即使你用 HTTPS 克隆主仓,子模块仍会走 SSH。
解决方法只有两个方向:
- 补全 SSH 认证:确保子模块用到的账户已将公钥添加到 GitHub,并且
ssh-add加载了对应私钥(注意多密钥场景下要指定-i) - 临时切 HTTPS:编辑
.gitmodules,把所有git@github.com:替换成https://github.com/,再运行git submodule sync和git submodule update --init --recursive
最容易被忽略的是:SSH agent 生命周期和终端环境隔离。你在 VS Code 终端里 ssh-add 成功了,换个 Terminal 窗口就得重来;CI 流水线里没启动 agent,或者没配置 SSH_AUTH_SOCK,也会静默失败。

















