rebase：变基原理、与 merge 的取舍、黄金法则

              D --- E   (feature)
             /
        A --- B --- C   (main)

                          D' --- E'   (feature)
                         /
        A --- B --- C   (main)

build() {
  git init -q $1 && cd $1
  echo 'base' > app.txt && git add . && git commit -q -m "A: 共同基础"
  git switch -qc feature
  echo 'f1' > f1.txt && git add . && git commit -q -m "D: feature 提交1"
  echo 'f2' > f2.txt && git add . && git commit -q -m "E: feature 提交2"
  git switch -q main
  echo 'm1' > m1.txt && git add . && git commit -q -m "B: main 提交1"
  echo 'm2' > m2.txt && git add . && git commit -q -m "C: main 提交2"
  cd ..
}
 
echo '############ 起点：历史分叉 ############'
build base0 && cd base0 && git log --oneline --graph --all && cd ..
echo
 
echo '############ 方案一：git merge main ############'
build repo-merge && cd repo-merge
git switch -q feature && git merge main --no-edit > /dev/null
git log --oneline --graph --all
echo '(多了一个合并提交，历史保留了分叉的形状)'
cd ..
echo
 
echo '############ 方案二：git rebase main ############'
build repo-rebase && cd repo-rebase
git switch -q feature
echo '变基前 feature 独有提交的哈希：'
git log --format='%h %s' main..feature
git rebase main
echo '变基后的历史：'
git log --oneline --graph --all
echo '变基后 feature 独有提交的哈希（换了一批！）：'
git log --format='%h %s' main..feature
cd ..

git init -q
echo 'v0' > app.txt && git add . && git commit -q -m "init"
git switch -qc feature
echo 'feature-version' > app.txt && git commit -qam "feat: feature 改了这行"
git switch -q main
echo 'main-version' > app.txt && git commit -qam "feat: main 也改了这行"
 
git switch -q feature
echo '===== 在 feature 上执行 git rebase main ====='
git rebase main
echo
 
echo '===== 冲突标记：HEAD 里居然是 main 的内容 ====='
cat app.txt
echo
 
echo "索引 :2 (ours)   = $(git show :2:app.txt)"
echo "索引 :3 (theirs) = $(git show :3:app.txt)"
echo
echo '原因：rebase 先把 HEAD 移到 main（所以 ours=main），'
echo '      再把你的提交当成「外来补丁」逐个重放（所以 theirs=你自己）。'
echo
 
echo '===== 解决 -> add -> rebase --continue ====='
echo 'merged: main + feature' > app.txt
git add app.txt
GIT_EDITOR=true git rebase --continue
echo
git log --oneline --graph --all

git rebase --onto <新基底> <旧基底> <要搬的分支>

git init -q
echo base > a.txt && git add . && git commit -q -m "A: main 基础"
git switch -qc feature
echo f > f.txt && git add . && git commit -q -m "B: feature 基础功能"
git switch -qc feature-sub
echo s1 > s1.txt && git add . && git commit -q -m "C: 子功能1"
echo s2 > s2.txt && git add . && git commit -q -m "D: 子功能2"
git switch -q main
echo m > m.txt && git add . && git commit -q -m "E: main 新提交"
 
echo '===== 起点 ====='
git log --oneline --graph --all
echo
echo '需求：只把 C、D 搬到 main 上，不要带上 B'
echo '命令：git rebase --onto main feature feature-sub'
echo '含义： 搬到 main   从 feature 之后   搬 feature-sub'
echo
 
git switch -q feature-sub
git rebase --onto main feature feature-sub
echo
git log --oneline --graph --all
echo
echo '(C、D 挂到了 main 后面；B 仍然留在 feature 分支上)'

# 删掉 HEAD~2 这个提交，保留它后面的两个
git rebase --onto HEAD~3 HEAD~2 HEAD

1. 你推送了 feature 分支，包含提交 D、E
   远程: A - B - D - E
   
2. 同事拉取，基于 E 写了提交 F
   同事: A - B - D - E - F
   
3. 你在本地 rebase，D、E 变成了 D'、E'，然后 force push
   远程: A - B - C - D' - E'
   
4. 同事再次 pull —— Git 看到远程的 D'、E' 和本地的 D、E 是不同的提交，
   会把它们全部合并进来：
   同事: A - B - C - D' - E' - D - E - F - M
   
   同一份改动出现了两次，还带一个莫名其妙的合并提交。

# 单次
git pull --rebase
 
# 设为默认（推荐）
git config --global pull.rebase true

pull（merge 模式）:
   A - B - C ------ M   (你的 main)
        \          /
         D -- E ---        <- 你本地的提交 D、E 和远程的 C 合并
 
pull --rebase:
   A - B - C - D' - E'    (你的 main)   <- 你的提交被重放到远程之后