GitHub 推送时报错：致命错误鉴权失败 的解决办法

在使用GitHub的时候, 提交命令 git push 时，可能会遇到以下错误提示：

$ git push
Username for 'https://github.com': Username
Password for 'https://Username@github.com':
remote: Invalid username or password.
fatal: Authentication failed for 'https://github.com/username/repository.git/'

这意味着在进行Git推送时，由于用户名或密码不正确，导致认证失败。随着 GitHub 对用户安全要求的提升，GitHub 已经停止了对基于用户名和密码的访问认证，改为使用 Personal Access Token（个人访问令牌） 来进行身份认证。

解决方法：使用 GitHub Personal Access Token (PAT)

以下是通过创建 GitHub 个人访问令牌来解决该问题的详细步骤：

步骤 1：登录 GitHub 账号，进入设置中心

1. 登录你的 GitHub 账号。
2. 在页面右上角点击个人头像，选择 Settings（设置）。

步骤 2：进入开发者设置

1. 在 Settings（设置） 页面左侧菜单，向下滚动到底部，找到 Developer settings（开发者设置），点击进入。

步骤 3：选择 Personal Access Tokens

1. 在 Developer settings（开发者设置） 页面，选择左侧菜单中的 Personal access tokens（个人访问令牌）。
2. 然后点击 Tokens (classic)，因为这是创建传统访问令牌的区域。

步骤 4：生成新令牌

1. 点击 Generate new token（生成新令牌） 按钮，进入生成新令牌的页面。

步骤 5：配置令牌权限

1. 在生成令牌的页面，为令牌选择合适的权限。在大多数情况下，建议选择 repo，以便该令牌可以完全访问仓库相关的操作。
2. 设置令牌的有效期（Expiration）。如果你希望令牌永久有效，可以设置为无过期时间。不过，出于安全考虑，建议设置合适的有效期，令牌到期后可以重新生成。

步骤 6：设置令牌过期时间

1. 在 Expiration 下拉框中，可以设置令牌的有效期。如果你想让令牌永久有效，可以选择 No expiration（无过期时间）。但出于安全原因，推荐设置合理的有效期限，便于定期更换。
2. 为令牌设置名称以便于后续管理。

步骤 7：生成并保存令牌

1. 点击页面下方的 Generate token（生成令牌） 按钮，生成新的访问令牌。
2. 注意：令牌生成后只会显示一次，请立即复制并妥善保存。此令牌将用于后续的 Git 操作。

步骤 8：使用令牌进行 Git 操作

1. 当你下次运行 git push 或其他需要身份认证的 Git 操作时，使用生成的访问令牌作为密码即可。

2. 示例操作：

   $ git push
   Username for 'https://github.com': your_username
   Password for 'https://github.com': <生成的Personal Access Token>

注意事项：

• 令牌一旦过期，你需要重复以上步骤重新生成新的令牌。
• 为了简化 Git 认证过程，你也可以使用 SSH 密钥进行认证，详细教程请参考 GitHub 官方 SSH 配置文档。

通过以上步骤，你应该能够解决 Git 推送时的鉴权失败问题，顺利推送代码到 GitHub 仓库。

版权声明：本文为原创文章，版权归 全栈开发技术博客 所有。

本文链接：https://www.lvtao.net/tool/github-push-authentication-failed.html

转载时须注明出处及本声明