标签与版本发布：轻量标签、附注标签与语义化版本

echo '===== 打标签 ====='
git init -q -b main repo && cd repo
echo 'v1' > app.txt && git add . && git commit -q -m "feat: 1.0 功能"
echo 'v2' > app.txt && git add . && git commit -q -m "feat: 2.0 功能"
echo 'v3' > app.txt && git add . && git commit -q -m "feat: 3.0 功能"
 
echo '打一个轻量标签（只是指向提交的指针）：'
git tag v1.0
echo '打一个附注标签（独立对象，有作者/日期/信息）：'
git tag -a v2.0 -m "正式发布 2.0 版本"
echo
echo '标签列表：'
git tag
echo
echo 'v2.0 是附注标签，能看到作者和信息：'
git show v2.0 --no-patch --format='作者: %an  日期: %ad%n信息: %s' --date=short
echo
echo 'v1.0 是轻量标签，show 只显示提交本身：'
git show v1.0 --no-patch --format='%h %s'
cd ..

git tag                         # 列出所有标签
git tag -l "v1.*"              # 按通配符过滤
git show v2.0                  # 查看标签指向的提交/附注
git checkout v2.0              # 检出到标签（进入分离 HEAD 状态）
git tag -d v1.0                # 删除本地标签

echo '===== 给历史中的旧提交补打标签 ====='
cd repo
echo '1.0 的功能其实在第一个提交，给旧提交补打 v0.9：'
FIRST=$(git rev-list --max-parents=0 HEAD)
git tag -a v0.9 -m "早期预览版" $FIRST
echo '按照版本号排序查看所有标签：'
git tag -l --sort=v:refname
cd ..

echo '===== 推送标签 / 删除标签 ====='
git init -q --bare /tmp/origin.git
cd repo
git remote add origin /tmp/origin.git
echo '默认 git push 不会推标签，需显式 --tags：'
git push -q -u origin main 2>/dev/null
git push -q origin --tags 2>/dev/null
echo '远程现在有哪些标签：'
git ls-remote --tags origin
echo
echo '误打了一个标签，本地删除 + 远程删除：'
git tag -d v0.9
git push -q origin :refs/tags/v0.9 2>/dev/null
echo '远程标签列表（v0.9 已消失）：'
git ls-remote --tags origin
cd ..

git push origin v1.2.0        # 推单个指定标签
git push origin --tags        # 推所有本地有、远程没有的标签