Git：配置仓库实现克隆时自动设置upstream远程仓库

Great question! Unfortunately, Git doesn’t have a built-in way to make a repository automatically include an upstream remote when someone clones it—by default, git clone only sets up the origin remote pointing to the repo you cloned from. But there are a few handy workarounds to avoid manually running git remote add upstream <url> every time:

1. Use a Git Template with a Post-Checkout Hook #

You can create a global Git template that runs a script after every clone to automatically add the upstream remote (for specific repos). Here’s how:

• Create a template directory, e.g., ~/.git-templates
• Inside it, make a hooks folder, then create a post-checkout script (make sure it’s executable with chmod +x post-checkout):

  #!/bin/sh
  # Check if this is the target repo to add upstream to
  ORIGIN_URL=$(git remote get-url origin)
  if [ "$ORIGIN_URL" = "https://github.com/your-username/your-repo.git" ]; then
      git remote add upstream "https://github.com/original-owner/original-repo.git"
  fi
  

• Tell Git to use this template globally:

  git config --global init.templatedir '~/.git-templates'
  

Now every time you clone your target repo, the hook will run and add the upstream remote automatically.

2. Write a Custom Clone Script #

Make a simple shell script to replace the default git clone for your specific repo. Save this as git-clone-myrepo.sh (then run chmod +x to make it executable):

#!/bin/bash
# Clone the repo
git clone "https://github.com/your-username/your-repo.git"
# Move into the repo directory
cd your-repo
# Add the upstream remote
git remote add upstream "https://github.com/original-owner/original-repo.git"

Just run this script instead of git clone, and it’ll handle both steps in one go. For flexibility, you can modify it to accept repo URLs as arguments if you need to support multiple repos.

3. Add a One-Liner Command to Your Repo’s README #

While not fully automatic, this makes the process trivial for anyone cloning your repo. Add this line to your README:

git clone https://github.com/your-username/your-repo.git && cd your-repo && git remote add upstream https://github.com/original-owner/original-repo.git

Users just need to copy-paste this single command, and they’ll have the repo cloned with the upstream remote already set up.

Quick Note #

The reason Git doesn’t support this natively is that upstream is typically tied to fork workflows, where every fork might have a different upstream repo. Git avoids making assumptions here to prevent unexpected behavior.

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