Git分支管理之分支创建、切换和合并操作详解

# 查看 HEAD 的指向
cat .git/HEAD
# 输出：ref: refs/heads/master

# 在当前提交上创建一个叫 dev 的分支
git branch dev

# 实际就是创建了 .git/refs/heads/dev 文件
# 文件内容：当前 commit 的 SHA-1
cat .git/refs/heads/dev
# 输出：abc1234567890abcdef1234567890abcdef123456

git branch
# 输出：
# * master
# 带 * 号的是当前所在分支

git branch -a

# 创建一个叫 dev 的分支（基于当前所在分支）
git branch dev

# 验证
git branch
# 输出：
#   dev
# * master
# （dev 已存在，但 HEAD 还在 master）

git checkout dev

# 验证
git branch
# 输出：
# * dev
#   master
# （* 号跳到了 dev）

# 老语法
git checkout -b dev

# 新语法（Git 2.23+，更清晰）
git switch -c dev

Switched to a new branch 'dev'

# 基于某个 commit id 创建分支
git branch <branch-name> <commit-id>

# 基于远程分支创建本地分支
git branch <local-branch> origin/<remote-branch>

# 删除已合并的分支（-d 是 --delete 的简写）
git branch -d dev

# 强制删除（即使没合并也删，慎用！）
git branch -D dev

# 1. 看现在在哪
git branch
# * master

# 2. 创建并切到 dev
git checkout -b dev
# Switched to a new branch 'dev'

# 3. 在 dev 上做改动
echo "这是 dev 分支的修改" >> ReadMe
git add ReadMe
git commit -m "dev: 添加 dev 分支说明"

# 4. 切回 master
git checkout master
# Switched to branch 'master'

# 5. 看 ReadMe 的内容
cat ReadMe
# （dev 分支的修改不见了！因为它在 dev 分支上）

# 6. 把 dev 合并回 master
git merge dev
# 输出（fast-forward 模式）：
# Updating abc1234..def5678
# Fast-forward
#  ReadMe | 1 +
#  1 file changed, 1 insertion(+)

# 7. dev 分支可以删了
git branch -d dev

# 在 master 上执行
git merge dev
# 输出：
# Updating abc1234..def5678
# Fast-forward
#  ReadMe | 1 +
#  1 file changed, 1 insertion(+)

# 准备工作
mkdir -p /home/user/test/merge-test
cd /home/user/test/merge-test
git init
echo "v1" > ReadMe
git add .
git commit -m "v1"

# 创建 dev 分支
git checkout -b dev
echo "v2 in dev" >> ReadMe
git add .
git commit -m "v2 in dev"

# 切回 master，合并
git checkout master
git merge dev
# Fast-forward
#  ReadMe | 1 +
#  1 file changed, 1 insertion(+)

# 查看日志
git log --pretty=oneline
# def5678 (HEAD -> master, dev) v2 in dev
# cff9d1e v1
# 注意：master 和 dev 都指向同一个 commit

Fast-forward 后的历史（看不出来分叉过）：

C0 ── C1 ── C2 ── C3 ── C4

# 强制使用非 fast-forward 合并
git merge --no-ff -m "合并 dev 分支" dev

# 图形化显示
git log --graph --pretty=oneline --abbrev-commit

# 加上 --all 看所有分支
git log --graph --pretty=oneline --abbrev-commit --all

*   c123456 (HEAD -> master) Merge branch 'dev'
|\
| * d789abc (dev) v2 in dev
|/
* a456789 v1

git config --global alias.lg "log --graph --pretty=oneline --abbrev-commit --all"

# 1. 在 master 上改 ReadMe
git checkout master
echo "hello master" > ReadMe
git add .
git commit -m "master: 改 ReadMe"

# 2. 切到 dev 改同一行
git checkout dev
echo "hello dev" > ReadMe
git add .
git commit -m "dev: 改 ReadMe"

# 3. 切回 master 合并 dev
git checkout master
git merge dev
# 输出：
# Auto-merging ReadMe
# CONFLICT (content): Merge conflict in ReadMe
# Automatic merge failed; fix conflicts and then commit the result.

<<<<<<< HEAD
hello master
=======
hello dev
>>>>>>> dev

# 编辑后：
hello master and dev

git add ReadMe

git commit -m "解决 ReadMe 合并冲突"

git status
# 输出（未解决）：
# Unmerged paths:
#   (use "git add <file>..." to mark resolution)
#         both modified:   ReadMe
# 
# 输出（已解决）：
# Changes to be committed:
#         modified:   ReadMe

git merge --abort

# 假设冲突发生
git merge dev
# CONFLICT 提示

# 1. 看哪些文件冲突
git status
# Unmerged paths: ReadMe

# 2. 编辑 ReadMe（保留两个版本）
vim ReadMe
# 改成你想要的内容，删除 <<<<<<< ======= >>>>>>> 标记

# 3. 标记解决
git add ReadMe

# 4. 查状态（应该没有 Unmerged paths 了）
git status
# Changes to be committed: ReadMe

# 5. 完成合并
git commit -m "merge dev: 解决 ReadMe 冲突"

# 6. 验证
git log --graph --pretty=oneline --abbrev-commit
# *   c123456 (HEAD -> master) merge dev: 解决 ReadMe 冲突
# |\
# | * d789abc (dev) dev: 改 ReadMe
# |/
# * a456789 master: 改 ReadMe

# 1. 你正在 dev 分支开发一个"用户登录"功能，写到一半
git checkout -b dev
echo "登录功能代码" > login.py
git add login.py
git commit -m "feat: 登录功能 - 1"

echo "登录功能代码 - 2" >> login.py
# （注意：这里没 commit，因为还没写完！）

# 把当前工作区和暂存区的改动"打包"起来
git stash

# 输出：
# Saved working directory and index state WIP on dev: abc1234 feat: 登录功能 - 1

# 2. 切到主分支修 Bug
git checkout master

# 3. 创建 bugfix 分支
git checkout -b bugfix-001

# 4. 修复 Bug 并提交
echo "付款 Bug 修复" > pay.py
git add pay.py
git commit -m "fix: 修复付款 Bug"

# 5. 切回 master 合并 bugfix
git checkout master
git merge --no-ff -m "merge bugfix-001" bugfix-001

# 6. 删除 bugfix 分支
git branch -d bugfix-001

# 7. 切回 dev 分支
git checkout dev

# 8. 把暂存的改动"恢复"出来
git stash pop

# 暂存当前改动（不带消息）
git stash

# 暂存并加消息（推荐，方便查找）
git stash push -m "修复登录功能写到一半"

# 查看所有 stash
git stash list

# 恢复最新 stash（不删除 stash）
git stash apply

# 恢复最新 stash（删除 stash，等价于 apply + drop）
git stash pop

# 恢复指定 stash
git stash apply stash@{0}    # 恢复第 1 个
git stash apply stash@{1}    # 恢复第 2 个

# 删除指定 stash
git stash drop stash@{0}

# 清空所有 stash
git stash clear

git stash push -m "改了一半的登录功能"
git stash push -m "性能优化草稿"
git stash push -m "UI 重构中"

git stash list
# stash@{0}: On dev: UI 重构中
# stash@{1}: On dev: 性能优化草稿
# stash@{2}: On dev: 改了一半的登录功能

git stash pop   # 恢复 stash@{0}（UI 重构中）
git stash pop   # 恢复 stash@{1}（性能优化草稿）
git stash pop   # 恢复 stash@{2}（改了一半的登录功能）

echo "新文件" > new.txt  # 创建新文件，没 add
git stash
# 暂存的是已追踪文件的改动，new.txt 不会暂存

git stash -u
# 或
git stash push -u -m "包含新文件"

# 1. 当前在 dev 分支，工作区有未提交的改动
git status
# modified: login.py

# 2. 老板紧急派活，先把当前改动暂存
git stash push -m "登录功能 - 未完成"

# 3. 切到 hotfix 分支修紧急 Bug
git checkout master
git checkout -b hotfix
# ... 修 Bug、提交、合并、删除分支 ...

# 4. 回到 dev 分支
git checkout dev

# 5. 恢复之前的改动
git stash pop

# 从 develop 创建 feature 分支
git checkout develop
git checkout -b feature/user-login

# 开发...
git add .
git commit -m "feat: 用户登录"

# 完成后合并回 develop
git checkout develop
git merge --no-ff -m "merge feature/user-login" feature/user-login

# 删除 feature 分支
git branch -d feature/user-login

# 从 develop 创建 release 分支
git checkout develop
git checkout -b release/v1.0.0

# 测试 + 修小 Bug
git commit -m "fix: 修复测试发现的 Bug"

# 测试通过，发布到 master
git checkout master
git merge --no-ff -m "release v1.0.0" release/v1.0.0
git tag v1.0.0  # 打 tag 标记版本

# 同步回 develop
git checkout develop
git merge --no-ff -m "merge release/v1.0.0 back to develop" release/v1.0.0

# 删除 release 分支
git branch -d release/v1.0.0

# 从 master 创建 hotfix 分支
git checkout master
git checkout -b hotfix/pay-bug

# 修复 Bug
git add .
git commit -m "fix: 紧急修复付款 Bug"

# 修复完成，合并到 master
git checkout master
git merge --no-ff -m "hotfix pay-bug" hotfix/pay-bug
git tag v1.0.1  # 升级版本号

# 同步到 develop
git checkout develop
git merge --no-ff -m "merge hotfix/pay-bug" hotfix/pay-bug

# 删除 hotfix 分支
git branch -d hotfix/pay-bug

# 1. 准备工作
mkdir -p /home/user/test/branch-workflow
cd /home/user/test/branch-workflow
git init
echo "v1" > app.py
git add .
git commit -m "init: 项目初始化"

# 2. 创建并切到 dev 分支
git checkout -b dev

# 3. 在 dev 上开发登录功能
echo "def login(): pass" > login.py
git add login.py
git commit -m "feat(login): 添加登录函数"

# 4. 突然老板让修付款 Bug
# 把当前未提交的改动暂存（假设我们正在改 login.py）
echo "def login_v2(): pass" >> login.py
git stash push -m "login v2 写到一半"

# 5. 切到 master 修付款 Bug
git checkout master
git checkout -b hotfix/pay-bug
echo "def pay(): fix" > pay.py
git add pay.py
git commit -m "hotfix(pay): 修复付款 Bug"

# 6. 合并回 master 并打 tag
git checkout master
git merge --no-ff -m "merge hotfix/pay-bug" hotfix/pay-bug
git tag v1.0.1
git branch -d hotfix/pay-bug

# 7. 回到 dev 继续开发
git checkout dev
git stash pop   # 恢复 login v2 的改动

# 8. 完成登录功能
git add login.py
git commit -m "feat(login): 完善登录功能"

# 9. 合并到 master
git checkout master
git merge --no-ff -m "merge dev" dev
git tag v1.1.0

# 10. 删除 dev 分支
git branch -d dev

# 11. 看完整历史
git log --graph --pretty=oneline --abbrev-commit --all
# *   d789abc (HEAD -> master, tag: v1.1.0) merge dev
# |\
# | * c456def (tag: v1.0.1) hotfix(pay): 修复付款 Bug
# |/
# * b123456 init: 项目初始化

# 开启颜色（推荐）
git config --global color.ui auto

# 关闭颜色
git config --global color.ui false

# 不管能不能 fast-forward，都产生 merge commit
git merge --no-ff -m "merge feature/login" feature/login

git stash       # 暂存当前
git stash       # 暂存第二个
git stash list  # 查看所有 stash
git stash pop   # 恢复最新（即第二个）
git stash pop   # 恢复最早（即第一个）

# 等价
git stash
git stash push

# 推 stash 时附加信息
git stash push -m "修复登录bug"

Unmerged paths:
  (use "git add <file>..." to mark resolution)
        both modified:   file.txt

# 1. 初始化
mkdir -p /home/user/test/git-branch-practice
cd /home/user/test/git-branch-practice
git init
echo "print('hello')" > app.py
git add .
git commit -m "init: app.py"

# 2. feature/pay
git checkout -b feature/pay
echo "def pay(): pass" > pay.py
git add pay.py
git commit -m "feat(pay): 添加支付函数"

# 3. feature/login
git checkout master
git checkout -b feature/login
echo "import os" >> app.py
git add app.py
git commit -m "feat(login): 添加 os 导入"

# 4. 回到 master 也改 app.py
git checkout master
echo "# 入口文件" >> app.py
git add app.py
git commit -m "docs: 添加 app.py 注释"

# 5. 合并 feature/login（会有冲突）
git merge feature/login
# CONFLICT 提示

# 编辑 app.py 解决冲突（保留两边的修改）：
# print('hello')
# # 入口文件
# import os
git add app.py
git commit -m "merge feature/login: 解决冲突"

# 6. 合并 feature/pay（fast-forward）
git merge feature/pay
# Fast-forward
#  pay.py | 1 +
#  1 file changed, 1 insertion(+)

# 7. 删除分支
git branch -d feature/login
git branch -d feature/pay

# 8. 看历史
git log --graph --pretty=oneline --abbrev-commit --all

# 1. 看所有 stash
git stash list
# stash@{0}: On dev: 改了一半的登录功能
# stash@{1}: On dev: 性能优化草稿

# 2. 看某个 stash 的内容（默认只看文件改动概览）
git stash show stash@{0}

# 3. 看完整 diff
git stash show -p stash@{0}

# 1. 看所有分支
git branch -a

# 2. 看哪些分支已合并到当前分支
git branch --merged

# 3. 看哪些分支**未**合并
git branch --no-merged

# 合并冲突中放弃合并
git merge --abort

# rebase 冲突中放弃
git rebase --abort

# 删除远程已删除但本地还残留的远程跟踪分支
git remote prune origin

# 或者用 fetch 时自动清理
git fetch --prune origin
# 简写
git fetch -p