如何使用JGit创建并关联本地与远程分支，无需发起合并请求

API 探路者

2026-9-24

JGit 创建并绑定本地+远程分支解决方案

错误原因说明

第一种方案报错原因：远程分支尚未创建时，就尝试以origin/superBranch作为本地分支的起始点，无法找到对应引用
第二种方案报错原因：第二次调用branchCreate方法设置上游时，没有指定setName("superBranch")参数，触发分支名空指针异常

正确实现代码

以下代码完全等效你列出的三条原生git命令，执行后可直接修改文件提交推送，无需合并请求：

// 已完成clone操作的场景可直接从下方步骤开始执行
// 1. 创建并切换到本地新分支 superBranch，等效 git checkout -b superBranch
git.checkout()
    .setCreateBranch(true)
    .setName("superBranch")
    .call();

// 2. 推送本地新分支到远程origin，等效 git push origin superBranch
RefSpec refSpec = new RefSpec()
    .setSourceDestination("superBranch", "refs/heads/superBranch");
git.push()
    .setRemote("origin")
    .setRefSpecs(refSpec)
    .setCredentialsProvider(provider) // 沿用你已配置的认证提供类
    .call();

// 3. 绑定本地分支与远程上游，等效 git push --set-upstream origin superBranch 的关联逻辑
git.branchCreate()
    .setName("superBranch")
    .setUpstreamMode(CreateBranchCommand.SetupUpstreamMode.SET_UPSTREAM)
    .setStartPoint("origin/superBranch")
    .setForce(true)
    .call();