如何在脚本中执行Git命令完成Bitbucket仓库提交与分支创建

首先确认前置条件：运行脚本的环境已经安装Git，本地已经拉取过对应Bitbucket仓库的完整副本，且已经配置好仓库的访问权限（SSH密钥或HTTPS凭据），手动执行Git拉取、推送操作无鉴权拦截。

方案1：通过subprocess调用原生Git命令（无额外依赖，稳定性最高） #

本质是在Python中执行手动操作时敲的Git命令，不需要安装第三方依赖，兼容所有Git版本，是生产环境脚本的首选方案。
示例代码：

import subprocess

def run_git_command(repo_path: str, cmd: list):
    """
    在指定仓库路径执行Git命令
    :param repo_path: 本地Bitbucket仓库的绝对路径
    :param cmd: Git命令参数列表，例：['checkout', '-b', 'new-feature']
    """
    full_cmd = ["git"] + cmd
    exec_result = subprocess.run(
        full_cmd,
        cwd=repo_path,
        capture_output=True,
        text=True,
        check=True
    )
    return exec_result.stdout.strip(), exec_result.stderr.strip()

if __name__ == "__main__":
    # 替换为本地仓库的实际路径
    REPO_PATH = "/your/local/bitbucket/repo/path"
    TARGET_BRANCH = "feature/auto-commit-task"
    COMMIT_INFO = "auto: script submit modified config files"

    try:
        # 先切到默认主分支拉取最新远程代码，避免版本冲突
        run_git_command(REPO_PATH, ["checkout", "main"])
        run_git_command(REPO_PATH, ["pull"])

        # 创建并切换到新分支
        run_git_command(REPO_PATH, ["checkout", "-b", TARGET_BRANCH])

        # 此处插入你的文件修改逻辑：比如更新配置、生成导出文件等
        # 所有修改完成后暂存文件，"."表示暂存所有改动，也可传入具体文件路径
        run_git_command(REPO_PATH, ["add", "."])

        # 检测是否有实际改动，无改动时跳过提交避免命令报错
        status_out, _ = run_git_command(REPO_PATH, ["status", "--porcelain"])
        if status_out:
            run_git_command(REPO_PATH, ["commit", "-m", COMMIT_INFO])
            # 将新分支推送到Bitbucket远程仓库，绑定上游分支
            run_git_command(REPO_PATH, ["push", "-u", "origin", TARGET_BRANCH])
            print(f"流程执行完成，新分支{TARGET_BRANCH}已推送至远程")
        else:
            print("未检测到文件改动，跳过提交推送")
    except subprocess.CalledProcessError as e:
        print(f"Git命令执行失败，错误详情：{e.stderr}")

注意事项：

• 不要把Git命令拼成完整字符串传入，要用参数列表格式传参，避免路径含空格、特殊字符时执行失败，同时规避命令注入风险。
• 不要在脚本里硬编码Bitbucket账号密码、个人访问令牌，敏感信息要存在环境变量或系统凭据管理器中。
• 执行commit命令前必须检测工作区改动状态，无改动时直接调用commit会返回非0退出码触发异常。

方案2：使用GitPython库（适合复杂Git操作场景） #

如果脚本涉及大量Git交互逻辑，可以用封装好的GitPython库提升代码可读性，先执行安装命令：pip install GitPython
示例代码：

from git import Repo

if __name__ == "__main__":
    REPO_PATH = "/your/local/bitbucket/repo/path"
    TARGET_BRANCH = "feature/gitpython-demo"
    COMMIT_INFO = "auto: submit via GitPython"

    # 加载本地仓库实例
    repo = Repo(REPO_PATH)
    if repo.bare:
        raise Exception("无效的Git仓库路径")

    # 拉取主分支最新代码
    repo.git.checkout("main")
    repo.remotes.origin.pull()

    # 创建并切换到新分支
    new_branch = repo.create_head(TARGET_BRANCH)
    new_branch.checkout()

    # 此处插入文件修改逻辑
    # 暂存所有改动（含未跟踪文件）
    repo.git.add(A=True)

    # 检测到改动才提交推送
    if repo.is_dirty(untracked_files=True):
        repo.index.commit(COMMIT_INFO)
        repo.remotes.origin.push(refspec=f"{TARGET_BRANCH}:{TARGET_BRANCH}", set_upstream=True)
        print("分支创建、提交、推送流程执行完成")

注意事项：

• GitPython并非纯Python实现的Git客户端，运行仍然依赖环境中安装的原生Git程序，使用前要先确认Git已加入系统环境变量。
• 简单的分支创建、提交推送场景下两种方案效率差异极小，如果脚本涉及变基、冲突处理、子模块操作等复杂逻辑，GitPython的可维护性明显优于手动拼subprocess命令。

常见踩坑提醒：如果是在CI/CD流水线中运行脚本，不要自己手动配置凭据，直接使用流水线提供的内置鉴权变量即可，能最大程度避免权限泄露问题。

内容的提问来源于stack exchange，提问作者Rahman The Man