Git操作：如何将分支仓库（Fork）的标签推送至源仓库（Origin）并显示在源仓库的Release/Tags页面？

Hey there! I get it—keeping tags synced between your fork and the upstream repo can be tricky, especially when you don’t want to forget the step later. Let’s walk through exactly how to do this, including handling old commit tags and setting up safeguards to avoid missing the push.

1. First, Make Sure You Have the Upstream Remote Configured #

If you haven’t already, link your local repo to the original upstream repository (this only needs to be done once):

git remote add upstream <your-upstream-repo-url>

Verify it’s set up correctly with:

git remote -v

You should see both origin (your fork) and upstream (the original repo) listed.

2. Push Existing Tags to Upstream #

Push a Single Tag #

If you’ve already created a tag like v1.0.1 in your fork, push it directly to the upstream repo with:

git push upstream v1.0.1

This will instantly make the tag appear in the upstream repo’s Tags page.

Push All Local Tags (Use Carefully) #

If you want to sync all your local tags to upstream (only do this if you’re sure all tags are meant for the upstream repo), run:

git push upstream --tags

3. Handle Tags for Old Commits #

Good news—old commit tags work exactly the same way! As long as the commit exists in the upstream repo (which it will, since your fork was cloned from it), pushing the tag to upstream will associate it with that old commit in the original repo’s Tags page. No extra steps needed here.

4. Avoid Forgetting to Push to Upstream #

To stop yourself from skipping the upstream push later, try these hacks:

Create a Git Alias #

Set up a shortcut for pushing tags to upstream so you don’t have to type the full command every time:

git config --global alias.push-upstream-tags 'push upstream --tags'

Now you can just run git push-upstream-tags after pushing to your fork, and all new tags will sync to upstream.

Use a Simple Script #

For a more automated workflow, create a small shell script to handle tagging and pushing to both repos at once. Save this as tag-and-push.sh:

#!/bin/bash

# Check for required arguments
if [ $# -ne 3 ]; then
    echo "Usage: $0 <tag-name> <commit-id> <tag-message>"
    exit 1
fi

TAG_NAME=$1
COMMIT_ID=$2
TAG_MESSAGE=$3

# Create the tag
git tag -a "$TAG_NAME" "$COMMIT_ID" -m "$TAG_MESSAGE"

# Push to your fork
git push origin "$TAG_NAME"

# Push to upstream
git push upstream "$TAG_NAME"

echo "Tag $TAG_NAME pushed to both origin and upstream!"

Make it executable with chmod +x tag-and-push.sh, then use it like this:

./tag-and-push.sh v1.0.2 abc1234 "My v1.0.2 release for old commit"

This way, you’ll never miss pushing to upstream again.

5. Link Tags to Upstream Releases #

Once the tag is in the upstream repo, you can still create a Release for it (even for old commits):

1. Go to the upstream repo’s Releases page.
2. Click Draft a new release.
3. In the Tag version dropdown, select the tag you just pushed.
4. Fill in the release details and publish—done!

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