分支基础：branch、switch 与两种合并

.git/refs/heads/main          内容: 15081dba7c2dc497df71c6b3f4f845188adbdb78
.git/refs/heads/feature       内容: 5cd08eab...
.git/HEAD                     内容: ref: refs/heads/main   <- 我现在在 main 上

        A <--- B <--- C  (main)
                      ^
                      |
                     HEAD

git init -q
echo 'main-1' > app.txt && git add . && git commit -q -m "feat: 主线提交1"
echo 'main-2' >> app.txt && git add . && git commit -q -m "feat: 主线提交2"
 
echo '===== 分支列表 ====='
git branch
echo
echo '.git/refs/heads/main 的内容：'
cat .git/refs/heads/main
echo '.git/HEAD 的内容：'
cat .git/HEAD
echo
 
echo '===== 创建并切换到新分支 ====='
git switch -c feature/login
git branch
echo '新分支文件的内容：'
cat .git/refs/heads/feature/login
echo '(和 main 完全一样 —— 创建分支只是复制了一个哈希)'
echo
 
echo '===== 在新分支上提交两次 ====='
echo 'login page' > login.txt && git add . && git commit -q -m "feat: 登录页"
echo 'login api' >> login.txt && git add . && git commit -q -m "feat: 登录接口"
git log --oneline --graph --decorate --all
echo
 
echo '===== 切回 main：工作区立刻变回去 ====='
git switch main
echo '目录内容：' && ls
echo '(login.txt 不见了 —— 它只存在于 feature/login 分支)'

# 查看
git branch                  # 本地分支，* 标记当前分支
git branch -v               # 带最后一次提交信息
git branch -a               # 包括远程分支
git branch --merged main    # 已并入 main 的分支（可以安全删）
git branch --no-merged main # 还没并入的分支（删了会丢代码）
 
# 创建 / 切换（新命令）
git switch -c feature/login       # 创建并切换
git switch -c hotfix main         # 基于 main 创建
git switch feature/login          # 切换
git switch -                      # 切回上一个分支
 
# 创建 / 切换（老命令，等价）
git checkout -b feature/login
git checkout feature/login
 
# 只创建不切换
git branch feature/login
 
# 重命名 / 删除
git branch -m old-name new-name
git branch -d feature/login       # 安全删：未合并会拒绝
git branch -D feature/login       # 强制删

git init -q
echo 'base' > app.txt && git add . && git commit -q -m "init"
git switch -qc done-work && echo x > x.txt && git add . && git commit -q -m "feat: 已完成的活"
git switch -q main && git merge -q done-work
git switch -qc wip-work && echo y > y.txt && git add . && git commit -q -m "wip: 没做完的活"
git switch -q main
 
echo '===== 所有分支及各自最新提交 ====='
git branch -v
echo
 
echo '===== 哪些分支已并入 main（可以删了）====='
git branch --merged main
echo
echo '===== 哪些还没并入（删了会丢代码）====='
git branch --no-merged main
echo
 
echo '===== -d 删除已合并分支：放行 ====='
git branch -d done-work
echo
 
echo '===== -d 删除未合并分支：拒绝 ====='
git branch -d wip-work
echo '(Git 在保护你，确实要删得用 -D)'
echo
 
echo '===== 重命名 ====='
git branch -m wip-work feature/wip
git branch

合并前：
        A --- B --- C  (hotfix)
        ^
        |
      main
 
git merge hotfix →  指针直接挪过去
 
合并后：
        A --- B --- C  (main, hotfix)

合并前：
              D --- E  (feature)
             /
        A --- B --- C  (main)
 
git merge feature
 
合并后：
              D --- E  (feature)
             /         \
        A --- B --- C --- M  (main)      M 有两个父提交：C 和 E

echo '################ A. Fast-forward ################'
git init -q ff && cd ff
echo 'base' > app.txt && git add . && git commit -q -m "init"
git switch -qc hotfix
echo 'fix' > fix.txt && git add . && git commit -q -m "fix: 紧急修复"
git switch -q main
echo '合并前（main 自分叉后没有新提交，是一条直线）：'
git log --oneline --graph --all
echo '-- git merge hotfix --'
git merge hotfix
echo '合并后：'
git log --oneline --graph --all
echo '(没有新的合并提交，main 指针直接快进到 hotfix)'
cd ..
echo
 
echo '################ B. 三方合并 ################'
git init -q tw && cd tw
echo 'base' > app.txt && git add . && git commit -q -m "init"
git switch -qc feature
echo 'feature work' > feat.txt && git add . && git commit -q -m "feat: 新功能"
git switch -q main
echo 'main work' > other.txt && git add . && git commit -q -m "feat: 主线也在动"
echo '合并前（两边都有新提交，历史分叉）：'
git log --oneline --graph --all
echo '-- git merge feature --'
git merge feature --no-edit
echo '合并后：'
git log --oneline --graph --all
echo '合并提交的两个父提交：'
git log -1 --format='%h 的父提交是: %p'
cd ..

git merge --no-ff feature/login

默认（可以 ff 时）:        --no-ff:
   A --- B --- C            A --------- M   (main)
                                 \     /
                                  B---C  (feature)

# 合并但不自动提交，给你机会检查/调整
git merge --no-commit feature
 
# 只在能 fast-forward 时才合并，否则报错（保证线性历史）
git merge --ff-only feature
 
# 合并出冲突了，放弃回到合并前
git merge --abort
 
# 查看某个分支相比 main 多了哪些提交
git log main..feature --oneline
 
# 查看两个分支的差异
git diff main..feature

# 1. 从最新的 main 开新分支
git switch main
git pull
git switch -c feature/coupon
 
# 2. 干活，小步提交
#    ...编辑...
git add -p && git commit -m "feat(coupon): 优惠券数据模型"
#    ...编辑...
git commit -am "feat(coupon): 领券接口"
 
# 3. 期间 main 有更新，同步过来（避免最后一次性解决一堆冲突）
git switch main && git pull
git switch feature/coupon
git merge main            # 或 git rebase main，见第 7 章
 
# 4. 完成，合回 main
git switch main
git merge --no-ff feature/coupon
 
# 5. 清理
git branch -d feature/coupon