外观
报错 remote: Repository not found 解决方法
clone 或 push 时报:
text
remote: Repository not found.
fatal: repository 'https://github.com/用户/仓库.git/' not found注意:GitHub 对私有仓库,即使存在,只要你没权限也会返回 "not found"(而非 403,防止暴露仓库是否存在)。所以这个错有多种成因。
方法一:先检查 URL 拼写(最容易被忽略)
bash
git remote -v核对:
- 用户名 / 组织名、仓库名有没有拼错、大小写(GitHub 仓库名对大小写敏感);
- 仓库是否已被改名或删除(去网页确认);
- 复制地址时有没有多/少字符。
改正地址:
bash
git remote set-url origin https://github.com/正确用户/正确仓库.git方法二:私有仓库需要认证
clone 私有仓库必须有有效凭证(PAT 或 SSH):
- HTTPS 方式:用 Personal Access Token,且 token 要有
repo权限,见 密码认证被移除改用 token; - SSH 方式:确保 key 已加到有权限的账号,见 Permission denied 排查。
方法三:token 权限 / SSO 不足
你有 token,但:
- token 没勾选
repo(读私有库需要)→ 重新生成并勾上; - 组织仓库开了 SSO,token 需在设置页点 Enable/Authorize SSO 授权给该组织。
方法四:本地存了错误账号的凭证
如果你有多个 GitHub 账号,git 可能用了另一个没权限的账号凭证:
- Windows:凭据管理器 → 删除
git:https://github.com条目; - macOS:钥匙串 → 删除
github.com密码;
删除后重新操作,用有权限的账号 PAT 认证。
方法五:确认你确实有访问权
- 你是否被加为该私有仓库的协作者 / 组织成员?
- 没权限就无法 clone——让仓库所有者添加你,或 fork 公开仓库到自己账号。
速查
| 情况 | 解决 |
|---|---|
| 地址拼错 / 仓库改名 | 方法一,改 remote url |
| 私有库未认证 | 方法二,PAT / SSH |
| token 没 repo 权限 / 缺 SSO | 方法三 |
| 多账号串了凭证 | 方法四,清旧凭证 |
| 确实无权限 | 方法五,申请访问 |
小结
- GitHub 对无权限的私有库返回 "not found",所以先分清是拼写还是权限。
- 私有库确保用对的账号 + 有 repo 权限的 token。
- 多账号环境记得清掉串错的旧凭证。
本文仅供技术学习与研究,请遵守所在国家/地区法律法规。