git 账号密码配置的核心就三件事:设置本地身份、保存凭证、让远程仓库通过校验,多数情况下用 git config 写用户名和邮箱,再配合 credential.helper 缓存密码,五分钟内就能完成。
git 账号密码配置怎么设置:从零到可用的完整流程
很多第一次接触Git的人会卡在输入账号密码后的“重复输入”问题,其实配置分为两层:身份配置和凭证存储配置,下面按顺序操作。
先配置提交身份
Git每次提交会记录用户名和邮箱,这跟远程账号密码不是同一件事,但第一次配置时容易混淆。
- 打开终端或Git Bash。
- 输入以下命令:
git config --global user.name "你的名字"git config --global user.email "你的邮箱"
- 检查配置:
git config --global --list
注意两点:邮箱最好与远程仓库账号邮箱一致,否则贡献统计可能不识别,名字可以随意,但建议用真实昵称,方便同事在提交记录里认出你。
再解决凭证存储
HTTPS方式克隆仓库时,第一次push或pull会提示输入账号密码,如果不想每次输入,需要配置credential.helper。
- Windows执行:
git config --global credential.helper manager-core - macOS执行:
git config --global credential.helper osxkeychain - Linux执行:
git config --global credential.helper cache --timeout=3600
这里解释一下cache和store的区别,cache把密码缓存在内存,默认保留15分钟,--timeout单位是秒,3600表示一小时,store把密码写进 ~/.git-credentials 文件,属于明文存储,不建议在公共电脑或多用户服务器上使用,Windows的manager-core和macOS的osxkeychain都交给系统级凭据管理器加密保存,安全性更好。
验证是否生效
- 重开终端,执行一次
git pull
或
git push。 - 如果不再弹出账号密码输入框,说明凭证已保存。
- 执行
git config --global --list | grep credential,应能看到helper的值。
git 账号密码配置在哪里修改?三端路径一次说清
当账号密码变更,或者需要切换账号时,必须知道去哪里改,很多开发者卡在推送报401这个阶段,不是配置有问题,而是旧凭证没清掉。
修改用户名和邮箱
- 全局修改:
git config --global user.name "新名字"和git config --global user.email "新邮箱"。 - 仅当前仓库修改:去掉
--global,在仓库目录下执行同样命令。 - 检查:
git config user.name可看当前生效值。
修改远程地址中的用户名
有些远程地址是 https://旧用户名@github.com/仓库.git,改密码后即使系统缓存了新密码,URL里的旧用户名也会导致认证失败。
- 查看远程地址:
git remote -v - 修改地址:
git remote set-url origin https://新用户名@github.com/仓库.git - 如果原地址没有带用户名,也可以手动加上,推送时会优先使用URL中的用户名。
清除已保存的旧密码
这是最容易被忽略的一步,只改密码不清旧凭证,Git会一直拿旧密码去试,导致认证失败。
- Windows:打开“控制面板” -> “用户账户” -> “凭据管理器” -> “Windows凭据”,找到
git:https://github.com或对应GitLab地址,删除后重新触发git操作。 - 命令行删除:
git credential-manager erase,回车后输入protocol=https和host=github.com,再空行结束。 - macOS:打开“钥匙串访问”,搜索git相关条目删除。
- Linux:如果使用store,直接编辑
~/.git-credentials删除对应行;使用cache则等缓存过期或重启。
git 账号密码配置和ssh对比:到底选哪个

很多教程会建议直接上SSH,但账号密码方式并非一无是处,搞清楚区别,才能选对方案。
| 对比项 | 账号密码配置 | SSH密钥配置 |
|---|---|---|
| 首次配置难度 | 低,输入账号密码即可 | 中,需生成密钥并添加公钥 |
| 后续操作体验 | 凭证缓存后接近免密 | 一次配置长期免密 |
| 切换账号 | 需清除缓存或改URL | 可配置多个Host或不同密钥 |
| 安全性 | 密码易被钓鱼或泄露,store存储有明文风险 | 私钥本地保存,难以远程截获 |
| 适用场景 | 新手、临时环境、公司内网HTTPS | 频繁推送、多设备长期开发 |
结论很直接:如果你刚接触Git,或者在公司内网只能用HTTPS,先把账号密码配置做好,如果每天要推送几十次,或经常在GitHub和GitLab之间切换,建议后期补上SSH。
git 账号密码配置错误怎么办?先看这三个命令
账号密码配置错误最常见的表现是:remote: Invalid username or password、fatal: Authentication failed、403 Forbidden,多数情况下不是网络问题,而是三个地方不一致。
三步排查法
- 先看身份:
git config --list | grep user,确认邮箱与远程账号一致,不一致不会直接导致认证失败,但会让贡献记录丢失。 - 再看远程地址:
git remote -v,检查地址中是否带旧用户名,是否用了http而非https,有些公司内网只开放https端口。 - 最后清凭证:按上面“在哪里修改”中的删除方式,清掉旧缓存,重新执行
git pull,会弹出完整账号密码输入窗,部分系统弹窗会带“在钥匙串中保存”选项,勾选后自动写入。
特殊场景:缓存后仍然每次要求输入
- 检查是否在多仓库目录下未设置全局credential.helper,Git全局配置对所有仓库生效,但某些客户端会使用独立配置。
- 执行
git config --global --list | grep credential查看是否真的写入成功。 - 如果值显示为空,重新执行
git config --global credential.helper manager-core,然后重开终端。

公司内网GitLab配置场景
有相当一部分公司使用自建GitLab,HTTPS证书为内部签发,此时账号密码配置本身没问题,但报错可能是证书校验失败。
- 短期解决:
git config --global http.sslVerify false - 建议做法:从公司IT获取内部CA证书,配置
http.sslCAInfo=/path/to/cert.pem
这属于额外的网络配置,但实际工作中和账号密码配置错误经常被混在一起。优先排查凭证和URL,再考虑证书问题。
Git账号密码配置并不复杂,复杂的是凭证缓存和远程地址之间的不一致,遇到认证失败,优先清旧凭证、检查URL、再重新输入,多数场景能直接解决,此后你就能把精力放到代码本身,而不是重复输入密码。
git 账号密码配置常见问题解答
git 账号密码配置可以记住密码吗?
可以,通过credential.helper配置凭证存储即可,Windows下使用manager-core,macOS下使用osxkeychain,Linux下可使用cache或store,store会保存为明文,不建议在多用户电脑上使用。
git 账号密码配置错误导致的401和403有什么区别?
401表示认证未通过,通常是密码错误或凭证过期,403表示没有权限访问目标仓库,账号密码可能是对的,但该账号没有对应项目的访问权限,解决403需要找仓库管理员授权,清凭证无效。
git 账号密码配置和ssh可以同时使用吗?
可以,同一台机器可以同时配置HTTPS账号密码缓存和SSH密钥,不同仓库使用不同远程地址即可,HTTPS仓库走凭据管理器,SSH仓库走密钥文件,两者互不影响。
