首页/开发/Git 与协作速查/git credential 凭据管理
Git 基础与命令88 条

git credential 凭据管理

用 credential.helper 管理远端认证凭据:cache 缓存在内存、store 写入明文文件、系统钥匙串集成方案更安全。

Git 与协作速查开发更新于 2026-10-13

凭据管理是什么

用凭据助手管理远端认证信息:缓存方式把凭据在内存里保留一段时间,明文存储方式写入用户目录文件,系统钥匙串集成方案更安全。选哪种取决于机器是否共享、是否需要免交互,以及令牌的有效期。

基本信息

配置键credential.helper
常用取值cache 内存缓存、store 明文文件、系统钥匙串方案
缓存时长cache --timeout=3600 指定保留秒数
调试命令git credential fill 会读取凭据,不要在共享环境执行
按站点区分credential.<地址>.helper 为特定站点指定不同助手

典型使用场景

  • 频繁推送时避免反复输入凭据
  • 自动化环境使用访问令牌而不是账号密码
  • 多账号切换时按站点指定不同的凭据来源
  • 排查认证失败时先确认实际使用的是哪个助手
  • 换新机器后重新规划凭据缓存策略

常用示例

常用示例
git config --global credential.helper cache                    # 内存缓存
git config --global credential.helper 'cache --timeout=3600'    # 保留一小时
git config --global credential.helper store                     # 明文写入文件
git config --global --get-all credential.helper                 # 查看已配置的助手
git credential-cache exit                                      # 立即清空内存缓存

方式对比

方式存储位置适用场景
cache内存,进程退出或超时后失效个人开发机,短时间免密
store用户目录下的明文文件自动化环境,风险可控
系统钥匙串操作系统凭据管理个人机器,安全性更好
明文存储会把凭据写进用户目录文件,公共或共享机器上慎用;确需使用时限制文件权限并定期轮换令牌。
更换助手后旧缓存可能仍然生效,先清空缓存再验证新配置,否则会误以为配置没有起作用。
自动化环境优先使用有效期较短、权限范围明确的访问令牌,并与具体仓库绑定,泄露后可以单独撤销而不影响其他系统。

易错点

  • 把访问令牌直接写进远端地址,凭据会随仓库配置一起泄露,应交给凭据助手管理
  • 多人共用的构建机上使用明文存储,任何能读取该文件的进程都能拿到令牌
  • 令牌过期或权限范围变更后仍在用旧缓存,表现为反复认证失败,先清缓存再重试
  • 在共享服务器上执行读取凭据的调试命令,会把凭据打印到终端历史里,排查应在个人环境进行

数据来源与参考

  • Git 官方文档:gitcredentials
  • Pro Git 2nd Edition · 7.14 凭据存储
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌