1. 简介
近年来，Git 在版本控制系统中的使用率迅速增长，逐渐取代了 Subversion 等传统工具。
随着 GitHub、GitLab 等免费平台的普及，我们能够更方便地进行代码版本管理与安全存储。
然而，频繁手动输入用户名和密码不仅繁琐，也不利于自动化 CI/CD 流水线的构建。
本篇文章将介绍如何配置 Git 凭据，以避免每次操作都需要手动输入。
2. 凭据输入机制
当 Git 需要连接远程仓库并进行身份验证时，它会尝试通过以下方式获取凭据：
- 检查环境变量
GIT_ASKPASS是否设置 - 检查配置项
core.askPass是否设置 - 检查环境变量
SSH_ASKPASS是否设置
如果这些变量都未设置，Git 将会退回到命令行提示用户输入用户名和密码。
这种方式虽然简单，但每次操作都手动输入显然效率低下。
3. 存储凭据的几种方式
3.1. URL 中直接包含用户名和密码
Git 支持在克隆仓库时将用户名和密码直接嵌入 URL：
$ git clone https://<username>:<password>@gitlab.com/group/project.git
⚠️ 注意：如果密码中包含特殊字符，需要进行 URL 编码，否则 shell 可能会解析错误。
你也可以手动修改 .git/config 文件来设置：
url = https://<username>:<password>@gitlab.com/group/project.git
✅ 优点：配置简单
❌ 缺点：凭据以明文形式存储，存在安全隐患
3.2. 按上下文配置用户名
Git 支持按远程地址配置用户名：
$ git config --global credential.https://github.com.username <your_username>
或者编辑全局配置文件 ~/.gitconfig：
[credential "https://github.com"]
username = <username>
✅ 优点：可针对不同平台配置不同用户名
❌ 缺点：仅支持用户名，不支持密码保存，Git 仍会提示输入密码
4. 使用 Credential Helper
Git 提供了 Credential Helper 来更安全地存储凭据，支持多种存储方式，甚至可以集成系统钥匙链。
4.1. Cache Helper（缓存凭据）
使用缓存凭据的方式，凭据会保存在内存中一段时间：
$ git config credential.helper cache
可以设置缓存时间（单位为秒）：
$ git config credential.helper 'cache --timeout=86400'
✅ 优点：无需写入磁盘，安全性较高
✅ 缺点：重启后凭据失效
4.2. Store Helper（持久化存储）
Store Helper 会将凭据以明文形式保存到本地文件中：
$ git config credential.helper store
默认保存在用户目录下，也可以指定路径：
$ git config credential.helper 'store --file=/full/path/to/.git_credentials'
✅ 优点：凭据持久化，重启后依然有效
❌ 缺点：文件为明文，需注意文件权限保护
4.3. 自定义 Credential Helper
Git 还支持自定义 Credential Helper，可以集成系统凭据管理器，如 macOS 的 Keychain、Windows 的 Credential Manager，或企业 LDAP/AD 等认证系统。
虽然大多数开发者不需要自己实现，但它的优势包括：
- 与系统安全机制集成
- 支持双因素认证
- 更细粒度的权限控制
4.4. 清除缓存凭据
如果想清除当前缓存的凭据，可以使用以下命令：
$ git config --global --unset credential.helper
根据配置作用域选择 --global、--local 或 --system。
5. 使用 SSH 密钥认证
SSH 是 Git 服务器常用的认证方式，相比 HTTPS 更加安全和便捷。
$ git clone git@gitlab.com:group/project.git
已有仓库可更新远程地址：
$ git remote set-url origin git@gitlab.com:group/project.git
配置步骤通常如下：
- 生成 SSH 密钥对（
ssh-keygen） - 将公钥上传到 Git 平台（如 GitHub、GitLab）
- 测试连接：
ssh -T git@github.com
⚠️ 注意：
- 私钥切勿泄露
- SSH 使用非标准端口，部分网络环境可能被限制
6. 总结
Git 提供了多种凭据管理方式，可以根据实际需求选择：
| 方式 | 安全性 | 易用性 | 适用场景 |
|---|---|---|---|
| URL 中嵌入凭据 | ❌ 低 | ✅ 高 | 临时使用 |
| 按上下文配置用户名 | ❌ 低 | ✅ 高 | 仅需用户名 |
| Cache Helper | ✅ 中 | ✅ 高 | 本地开发 |
| Store Helper | ✅ 中 | ✅ 高 | 持久化存储 |
| 自定义 Helper | ✅ 高 | ✅ 高 | 企业级集成 |
| SSH 密钥 | ✅ 高 | ✅ 中 | 长期项目、团队协作 |
✅ 推荐做法：
- 本地开发推荐使用
cache或store - 团队协作、CI/CD 推荐使用 SSH
- 企业级部署可考虑自定义 Credential Helper 集成 LDAP 或 Keychain
合理配置 Git 凭据，既能提升开发效率，也能保障代码安全。