如何用Octokit/原生Git给远程分支添加空提交（无需本地修改）

一、Octokit 代码修复（报错原因+正确实现） #

你之前的报错是因为直接把分支名传给了getTree的tree_sha参数——分支名指向的是提交对象（Commit），而非树对象（Tree），所以接口返回"Tree SHA is not a tree object"。正确流程应该是：获取分支最新提交→提取提交对应的树SHA→基于原提交创建新空提交→更新远程分支引用。

完整代码示例：

const octokit = new Octokit({ auth: 'YOUR_GITHUB_TOKEN' });
const GITHUB_OWNER = '你的仓库所有者';
const GITHUB_REPO = '你的仓库名';
const BRANCH_NAME = 'myBranch';

async function createEmptyCommit() {
  // 1. 获取远程分支的最新引用（拿到最新提交的SHA）
  const refResponse = await octokit.rest.git.getRef({
    owner: GITHUB_OWNER,
    repo: GITHUB_REPO,
    ref: `heads/${BRANCH_NAME}`
  });
  const latestCommitSha = refResponse.data.object.sha;

  // 2. 获取该提交对应的树对象SHA
  const commitResponse = await octokit.rest.git.getCommit({
    owner: GITHUB_OWNER,
    repo: GITHUB_REPO,
    commit_sha: latestCommitSha
  });
  const treeSha = commitResponse.data.tree.sha;

  // 3. 创建新的空提交（指定parent为原提交，保证分支历史连贯）
  const newCommitResponse = await octokit.rest.git.createCommit({
    owner: GITHUB_OWNER,
    repo: GITHUB_REPO,
    message: "my commit message",
    tree: treeSha,
    parents: [latestCommitSha]
  });
  const newCommitSha = newCommitResponse.data.sha;

  // 4. 更新远程分支引用，指向新提交
  await octokit.rest.git.updateRef({
    owner: GITHUB_OWNER,
    repo: GITHUB_REPO,
    ref: `heads/${BRANCH_NAME}`,
    sha: newCommitSha,
    force: false // 非强制推送，避免覆盖未同步的提交
  });
}

createEmptyCommit().catch(console.error);

二、原生Git 无本地改动脚本方案 #

如果不想用Octokit，可以通过临时裸仓库实现，完全不影响本地工作区：

#!/bin/bash
# 配置参数
OWNER="你的仓库所有者"
REPO="你的仓库名"
BRANCH="myBranch"
COMMIT_MSG="my commit message"
REMOTE_URL="git@github.com:${OWNER}/${REPO}.git" # 或HTTPS地址

# 创建临时裸仓库并操作
mkdir -p temp-empty-commit && cd temp-empty-commit && git init --bare
git remote add origin ${REMOTE_URL}

# 获取远程分支最新提交SHA
REMOTE_COMMIT=$(git ls-remote origin ${BRANCH} | awk '{print $1}')

# 创建空提交：复用原提交的树，指定原提交为父节点
NEW_COMMIT=$(echo "${COMMIT_MSG}" | git commit-tree ${REMOTE_COMMIT}^{tree} -p ${REMOTE_COMMIT})

# 推送新提交到远程分支
git push origin ${NEW_COMMIT}:${BRANCH}

# 清理临时文件
cd .. && rm -rf temp-empty-commit

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