为何执行git fetch会清空我的.git-credentials凭证文件？

问题背景 #

• 全局Git凭证存储在/home/user1/.git-credentials文件中
• 某仓库的.git/config中嵌入了错误的凭证，URL格式为https://username:password@example.com/your/project/
• 执行git fetch时出现预期内的认证失败错误：

  remote: Verify
  fatal: Authentication failed for 'https://example.com/your/project/'

• 异常行为：Git会清空/home/user1/.git-credentials文件，但保留.git/config中的无效凭证（涉及Git版本2.34.1）

原因分析 #

Git的凭证助手（credential helper）在处理认证失败时，会尝试管理凭证有效性。由于本地仓库配置中的凭证优先级高于全局凭证，当本地无效凭证导致认证失败时，2.34.1这类旧版本的Git凭证助手存在逻辑缺陷——未正确区分本地与全局凭证的作用域，误将本地认证失败的责任关联到全局凭证，进而触发删除操作，极端情况下会清空整个全局凭证文件。

解决方法 #

1. 修复本地仓库的无效凭证 #

首先移除或修正.git/config中的错误凭证条目：

git config --local --edit

找到包含错误凭证的url字段（格式如https://username:password@example.com/your/project/），修改为不带嵌入凭证的正确URL（https://example.com/your/project/），或直接删除该行后保存。

2. 配置凭证助手禁止自动删除 #

若使用store类型的凭证助手，可添加--no-delete参数阻止其删除已有凭证：

git config --global credential.helper 'store --no-delete'

该配置会让凭证助手仅存储新凭证，不会因认证失败删除已存在的条目。

3. 明确凭证作用域避免冲突 #

通过配置credential.useHttpPath让Git根据完整路径区分不同仓库的凭证，减少作用域混淆：

git config --global credential.useHttpPath true

内容的提问来源于stack exchange，提问作者bilogic