提示:如果您使用 SSH 克隆 GitHub 仓库,则可使用 SSH 密钥进行身份验证,而不是使用其他凭据。 有关设置 SSH 连接的信息,请参阅“生成 SSH 密钥”。
GitHub CLI
当您选择 HTTPS
作为 Git 操作的首选协议时,GitHub CLI 将自动为您存储 Git 凭据,并对询问您是否要使用 GitHub 凭据向 Git 进行身份验证的提示回答“是”。
- 在 macOS、Windows 或 Linux 上安装 GitHub CLI。
- 在命令行中,输入
gh auth login
,然后按照提示操作。- 当系统提示输入 Git 操作的首选协议时,请选择
HTTPS
。 - 当系统询问您是否要使用 GitHub 凭据向 Git 进行身份验证时,请输入
Y
。
- 当系统提示输入 Git 操作的首选协议时,请选择
有关使用 GitHub CLI 进行身份验证的详细信息,请参阅 gh auth login
。
Git Credential Manager
Git Credential Manager (GCM) 是安全存储凭据并通过 HTTPS 连接到 GitHub 的另一种方法。 使用 GCM,您不必手动创建和存储 PAT,因为 GCM 代表您管理身份验证,包括 2FA(双重身份验证)。
-
使用 Homebrew 安装 Git:
$ brew install git
-
使用 Homebrew 安装 GCM:
$ brew tap microsoft/git $ brew install --cask git-credential-manager-core
对于 MacOS,您不需要运行
git config
,因为 GCM 会自动为您配置 Git。
下次克隆需要身份验证的 HTTPS URL 时,Git 将提示您使用浏览器窗口登录。 如果您的帐户或组织需要双重身份验证,则您还需要完成 2FA 质询。
验证成功后,您的凭据存储在 macOS 密钥链中,每次克隆 HTTPS URL 时都会使用。 Git 不会要求您在命令行中再次键入凭据,除非您更改凭据。
- 安装 Windows 版 Git,其中包括 GCM。 更多信息请参阅其版本页面中的“Windows 版 Git”。
我们建议始终安装最新版本。 至少安装版本 2.29 或更高版本,这是第一个为 GitHub 提供 OAuth 支持的版本。
下次克隆需要身份验证的 HTTPS URL 时,Git 将提示您使用浏览器窗口登录。 如果您的帐户或组织需要双重身份验证,则您还需要完成 2FA 质询。
成功通过身份验证后,您的凭据将存储在 Windows 凭据管理器中,并且每次克隆 HTTPS URL 时都将使用。 Git 不会要求您在命令行中再次键入凭据,除非您更改凭据。
警告: 旧版本的 Windows 版 Git 附有 Windows 版 Git Credential Manager。 此旧产品不再受支持,并且无法通过 OAuth 连接到 GitHub。 我们建议您升级到最新版本的 Windows 版 Git。
警告:如果在 Windows 凭据管理器中缓存了不正确或过期的凭据,Git 将无法访问 GitHub。 若要重置缓存的凭据,以便 Git 提示您输入凭据,请在 Windows 控制面板中的“用户帐户”>“凭据管理器”下访问凭据管理器。 找到 GitHub 条目并将其删除。
对于 Linux,安装 Git 和 GCM,然后配置 Git 使用 GCM。
-
从发行版的打包系统安装 Git。 说明将根据您运行的 Linux 的风格而有所不同。
-
安装 GCM。 请参阅 GCM 存储库中的说明,因为它们会因您运行的 Linux 风格而异。
-
配置 Git 使用 GCM 有几个支持商店,您可以从中选择,因此请参阅 GCM 文档来完成设置。 更多信息请参阅“GCM Linux”。
下次克隆需要身份验证的 HTTPS URL 时,Git 将提示您使用浏览器窗口登录。 如果您的帐户或组织需要双重身份验证,则您还需要完成 2FA 质询。
验证成功后,您的凭据存储在系统中,每次克隆 HTTPS URL 时都会使用。 Git 不会要求您在命令行中再次键入凭据,除非您更改凭据。
有关在 Linux 上存储凭据的更多选项,请参阅 Pro Git 中的凭据存储 。
如需详细信息或报告 GCM 问题,请参阅 Git Credential Manager 上的官方 GCM 文档。