首次在GitHub创建仓库推送时报403权限拒绝错误如何解决

你遇到的报错是HTTPS方式连接GitHub时身份校验失败导致的权限拒绝，具体报错日志如下：

Username for 'https://github.com': ******`enter username here`
Password for 'https://m.erfanpld@github.com': `enter password here`
remote: Permission to MErfanPld/web.git denied to MErfanPld.
fatal: unable to access 'https://github.com/MErfanPld/web.git/': The requested URL returned error: 403

可按照以下步骤逐一排查解决：

1. 替换密码为个人访问令牌（PAT） #

GitHub自2021年8月起不再支持账号密码作为HTTPS连接的验证方式，必须使用个人访问令牌替代密码：

• 登录GitHub账号，进入右上角个人设置页面，找到「开发者设置」选项
• 进入「Personal access tokens」菜单，点击生成新令牌，按需设置有效期，勾选repo相关的所有权限，生成后复制保存令牌（令牌仅展示一次，丢失需要重新生成）
• 下次弹出密码输入提示时，直接粘贴生成的PAT作为密码提交即可

2. 清理本地存储的错误凭证 #

如果本地已经缓存了错误的账号密码/旧令牌，需要先删除旧凭证：

• Windows系统：打开控制面板→凭据管理器→Windows凭据，找到所有GitHub相关的凭证条目删除
• Mac系统：打开钥匙串访问应用，搜索GitHub，删除对应的密码条目
• Linux系统：执行命令git config --global --unset credential.helper清空本地凭证缓存

3. 核对远程仓库地址配置 #

执行命令git remote -v查看当前本地仓库绑定的远程地址，确认地址和你在GitHub上创建的仓库地址完全一致。如果地址有误，执行以下命令修改：

git remote set-url origin https://github.com/MErfanPld/web.git

4. 核对仓库权限 #

确认你的账号对MErfanPld/web仓库有读写权限，如果是跨账号协作的仓库，需要联系仓库所有者为你的账号开通推送权限。

内容的提问来源于stack exchange，提问作者mohammad erfan Pouladzadeh