MacOS下操作GitHub私有仓库遇Git鉴权失败问题求助

阿华AIGC实验室

2026-5-13

解决MacOS终端操作GitHub私有仓库的鉴权问题

别急，我来帮你一步步搞定这个问题——因为你启用了2FA（双因素认证），所以直接输账号密码肯定会鉴权失败，这是GitHub的安全机制，咱们用个人访问令牌（PAT）就能解决，顺便也帮你排查之前push后GitHub没显示内容的问题。

为什么密码/邮箱克隆会失败？

启用2FA后，GitHub会彻底拒绝用账号密码作为终端Git操作的凭据，必须用**个人访问令牌（PAT）**来替代密码。不管你输的是正确的密码还是邮箱，都过不了鉴权这一关。

打开GitHub网页端，按这个路径走：

点击右上角头像 → Settings → Developer settings → Personal access tokens → Tokens (classic)
点击「Generate new token」，给令牌起个名字（比如「Mac终端操作仓库」），然后勾选必要的权限：至少要选repo（这个权限能让你操作私有仓库），如果需要其他权限再按需勾选
生成后一定要立刻复制保存好，因为这个令牌只显示一次，关掉页面就找不回来了，丢了只能重新生成

有两种方式，选你方便的：

方式一：克隆时直接嵌入PAT（适合临时操作）
把克隆命令改成这样，把<你的PAT>替换成刚生成的令牌：
```
git clone https://<你的PAT>@github.com/my-username/my-Repo.git
```
执行后不用输用户名密码，直接就能克隆成功。
方式二：让Git把PAT存在钥匙串（一劳永逸）
先正常执行克隆命令：
```
git clone https://github.com/my-username/my-Repo.git
```
当终端提示「Username for 'https://github.com'」时，输入你的GitHub用户名；提示「Password for 'https://你的用户名@github.com'」时，输入你的PAT（不是账号密码！）。
这样Git会自动把这个凭据存在Mac的钥匙串里，后续的push、pull操作都不用再输凭据了。
如果之前钥匙串里有旧的无效凭据，先清理掉：
```
git credential-osxkeychain erase
```
执行后会提示你输入url=https://github.com，回车确认，再重新执行克隆/鉴权操作就行。

先按这几步检查：

检查本地仓库的远程地址是否正确：
```
git remote -v
```
看输出的地址是不是你目标私有仓库的地址，如果不对，用这个命令修改：
```
git remote set-url origin https://github.com/my-username/my-Repo.git
```
检查本地有没有提交记录：
```
git log
```
看看能不能找到你之前git add和git commit的记录，如果没有，说明你可能没执行git commit（只add没commit的话，内容不会被推送到远程）。
如果本地有提交但远程没显示，可能是第一次push没指定分支：
刚初始化的仓库，第一次push需要加上分支名和-u参数（比如你的分支是main）：
```
git push -u origin main
```
之后再push就不用加参数了。