GitPython如何为Repo对象添加用户名密码凭证实现代码推送

你可以通过以下两种方式实现带自定义凭证的推送，无需配置SSH密钥：

方法1：修改远程地址内嵌凭证（长期有效） #

直接将编码后的用户名、密码嵌入仓库的HTTPS地址中，更新本地仓库的远程配置后，后续推送会自动携带凭证：

import git
from urllib.parse import quote_plus

local_repo_path = "本地仓库文件夹路径"
git_username = "你的Git账号用户名"
# 若平台要求使用个人访问令牌(PAT)替代密码，此处填写你的PAT即可
git_credential = "你的Git账号密码/个人访问令牌"
repo_https_url = "你的仓库原始HTTPS地址（不带https://前缀）"

# 对凭证做URL编码，避免特殊字符导致地址解析错误
encoded_user = quote_plus(git_username)
encoded_pass = quote_plus(git_credential)
full_repo_url = f"https://{encoded_user}:{encoded_pass}@{repo_https_url}"

repo = git.Repo(local_repo_path)
origin = repo.remote("origin")
origin.set_url(full_repo_url)
# 执行推送
origin.push()

注意：该方式会将凭证明文存储在本地仓库的.git/config文件中，公共设备不建议使用该方案。

方法2：推送时临时传入凭证（不留存凭证，更安全） #

通过Git的环境变量临时注入凭证，推送完成后不会在本地留存任何凭证信息：

import git

local_repo_path = "本地仓库文件夹路径"
git_username = "你的Git账号用户名"
git_credential = "你的Git账号密码/个人访问令牌"

repo = git.Repo(local_repo_path)
with repo.git.custom_environment(
    GIT_USERNAME=git_username,
    GIT_PASSWORD=git_credential
):
    repo.remote().push()

常见权限报错排查 #

• 确认你的账号/个人访问令牌对目标仓库有写入权限
• 确认本地仓库当前配置的远程地址为HTTPS格式，而非SSH格式
• 凭证中包含@、/、空格等特殊字符时，必须先做URL编码再使用

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