Git Credential Manager

Git Credential Manager

Git Credential Manager（以下简称 GCM）是一个用于帮助用户管理 Git 凭据的工具。在进行 Git 操作时，我们通常会被要求输入用户名和密码，GCM 可以帮助我们保存这些凭据，避免重复输入，提高工作效率。本文将详细介绍 GCM 的安装、配置和使用方法，并介绍一些常见的场景和问题。

1. 安装

GCM 可以在 Windows、macOS 和 Linux 系统上使用，并支持多种版本控制系统，包括 Git、GitHub、Azure Repos 等。下面将会分别介绍在不同系统下的安装方法。

1.1 Windows

在 Windows 上安装 GCM 最简单的方式是通过 git 官方的安装程序来完成。首先，前往 https://git-scm.com/download/win 下载最新版本的 Git，并运行安装程序。在安装过程中，可以选择安装 Git Credential Manager for Windows。

1.2 macOS

在 macOS 上安装，可以通过 Homebrew 包管理器来安装 Git 和 Git Credential Manager。在终端中执行以下命令：

brew update

brew install git

brew install git-credential-manager-core

1.3 Linux

在大部分 Linux 发行版中，GCM 已经可以通过包管理器进行安装。以 Ubuntu 为例，在终端中执行以下命令：

sudo apt update

sudo apt install git

sudo apt install gcm

安装完成后，可以通过运行以下命令来验证是否安装成功：

git credential-manager version

2. 配置

安装完成后，我们需要对 GCM 进行一些基本配置，以确保它能够正常工作。以下是几个常见的配置步骤：

2.1 配置 Git 全局用户名和邮箱

在使用 GCM 之前，我们首先需要配置 Git 的全局用户名和邮箱，用于标识代码提交者。在终端中运行以下命令：

git config --global user.name "Your Name"

git config --global user.email "Your Email"

2.2 启用 Git Credential Manager

GCM 需要在 Git 的配置中启用才能发挥作用。在终端中执行以下命令：

git config --global credential.helper manager

2.3 配置存储方式

GCM 默认会将凭据保存在操作系统的凭据管理器中。但我们也可以选择将凭据保存在文件中，或是手动输入凭据。以下是几种常见的配置方式：

使用操作系统凭据管理器（默认）：

git config --global credential.credentialStore osxkeychain (macOS)

git config --global credential.credentialStore wincred (Windows)

git config --global credential.credentialStore gnome-keyring (Linux)

将凭据保存在文件中：

git config --global credential.credentialStore file

手动输入凭据：

git config --global credential.credentialStore ""

注意：手动输入凭据将在每次操作时都要求输入用户名和密码。

3. 使用

在完成上述配置后，我们可以开始使用 GCM 来管理 Git 凭据了。下面将介绍几个常见的使用场景和问题。

3.1 克隆远程仓库

首先，我们可以使用以下命令克隆一个远程仓库：

git clone https://github.com/your-username/your-repo.git

如果之前已经配置好了 GCM，并且保存了用户名和密码，那么在克隆仓库时将不需要再次输入凭据。

3.2 提交代码

在进行代码提交时，如果之前已经配置好了 GCM，那么在提交时无需手动输入用户名和密码，GCM 会自动使用已保存的凭据。

git add .

git commit -m "Commit message"

git push

3.3 更新凭据

如果需要更新保存的凭据，可以运行以下命令：

git credential-manager erase

git credential-manager get

首先使用 erase 命令清除旧的凭据，然后通过 get 命令获取新的凭据。

3.4 使用 Personal Access Token（PAT）

有时候，为了提高安全性，我们可能会选择使用 Personal Access Token（简称 PAT）来替代密码进行认证。GCM 同样支持使用 PAT 进行身份验证。只需要将 PAT 作为密码输入即可。

3.5 故障排除

在使用 GCM 过程中，有时可能会遇到一些问题。以下是几个常见的故障排除方法：

如果遇到无法连接远程仓库的问题，可以先尝试运行以下命令来验证凭据是否正确：

git credential-manager fetch

如果凭据保存在文件中，可以尝试手动删除文件中的凭据，然后重新认证：

rm ~/.git-credentials

git config --global --remove-section credential

如果使用的是较旧版本的 GCM，可能会遇到一些 bug。可以尝试升级到最新版。