git branch#

查看本地分支。

1
git branch

示例：

1
* master
2
  dev
3
  feature/login

git branch -r#

查看远程跟踪分支。

1
git branch -r

示例：

1
origin/master
2
origin/dev
3
upstream/master

git branch -a#

查看本地分支和远程跟踪分支。

1
git branch -a

git branch -vv#

查看本地分支、当前提交、上游跟踪关系及领先或落后状态。

1
git branch -vv

示例：

1
* master  2bd887e8 [origin/master] Merge upstream/master
2
  dev     a1234567 [origin/dev: ahead 2] test

适用场景：

• 查看当前分支跟踪哪个远程分支
• 查看本地分支相对远程分支是否领先或落后

git log --graph --oneline --decorate --all#

以图形方式查看所有分支的提交历史。

1
git log --graph --oneline --decorate --all

示例：

1
*   2bd887e8 (HEAD -> master) Merge upstream/master
2
|\
3
| * 567313c1 (upstream/master) chore: update dependencies
4
| * ffd881d0 fix: resolve issue
5
* | 2aea090d feat: add new feature
6
|/
7
* abcdef12 previous commit

参数含义：

git log A..B --oneline#

查看 B 中存在、但 A 中不存在的提交。

例如：

1
git log master..upstream/master --oneline

表示查看：

1
upstream/master 有、master 没有的提交

反过来：

1
git log upstream/master..master --oneline

表示查看：

1
master 有、upstream/master 没有的提交

git diff A..B#

比较两个分支最终文件内容的差异。

1
git diff master..upstream/master

适用场景：

• 查看两个分支在文件内容上的差异
• 合并前检查修改内容

git merge-base <branch1> <branch2>#

查找两个分支最近的共同祖先提交。

1
git merge-base master upstream/master

执行前：

1
A---B---C---D
2
         \
3
          E---F

git reflog#

查看 HEAD 和本地分支指针近期移动记录。

1
git reflog

示例：

1
a1b2c3d HEAD@{0}: merge feature
2
d4e5f6a HEAD@{1}: commit: update implementation
3
7a8b9c0 HEAD@{2}: checkout: moving from feature to main

适用场景：

• 查找 Reset 前的提交
• 查找 Rebase 前的提交
• 查找误删除分支之前的位置

git branch <branch>#

从当前提交创建一个新分支，但不切换过去。

1
git branch dev

执行前：

1
A---B---C
2
        ↑
3
      master
4
      HEAD

执行后：

1
A---B---C
2
        ↑
3
   master, dev
4

5
HEAD -> master

git switch -c <branch>#

创建分支并立即切换到该分支。

1
git switch -c dev

执行前：

1
A---B---C
2
        ↑
3
      master
4
      HEAD

执行后：

1
A---B---C
2
        ↑
3
   master, dev
4
          ↑
5
         HEAD

等价于：

1
git branch dev
2
git switch dev

git switch -c <branch> <start-point>#

从指定提交或分支创建新分支并切换。

1
git switch -c feature upstream/master

执行前：

1
A---B---C
2
        ↑
3
 upstream/master

执行后：

1
A---B---C
2
        ↑
3
 upstream/master
4
 feature
5
 HEAD

适用场景：

• 从远程最新分支创建开发分支
• 从指定历史提交创建修复分支

git branch <branch> <commit>#

从指定提交创建分支。

1
git branch recovery abc1234

执行前：

1
A---B---C---D
2
    ↑
3
 abc1234

执行后：

1
A---B---C---D
2
    ↑
3
 recovery

适用场景：

• 根据 git reflog 找回误删除的分支
• 从历史提交创建临时修复分支

git switch <branch>#

切换到已有分支。

1
git switch dev

执行前：

1
A---B---C
2
        ↑
3
   master, dev
4

5
HEAD -> master

执行后：

1
A---B---C
2
        ↑
3
   master, dev
4

5
HEAD -> dev

git checkout <branch>#

旧版 Git 中常用的分支切换写法。

1
git checkout dev

效果与以下命令相同：

1
git switch dev

git checkout -b <branch>#

旧版 Git 中用于创建并切换分支。

1
git checkout -b dev

效果与以下命令相同：

1
git switch -c dev

git branch -m <new-name>#

重命名当前分支。

1
git branch -m main

执行前：

1
A---B---C
2
        ↑
3
      master

执行后：

1
A---B---C
2
        ↑
3
       main

git branch -m <old-name> <new-name>#

重命名指定分支。

1
git branch -m master main

git branch -d <branch>#

安全删除本地分支。

1
git branch -d dev

如果该分支存在尚未合并的提交，Git 通常会拒绝删除。

执行前：

1
A---B---C---D
2
        ↑   ↑
3
     master dev

执行后：

1
A---B---C---D
2
        ↑
3
      master

git branch -D <branch>#

强制删除本地分支。

1
git branch -D dev

适用场景：

• 明确不再需要该分支
• 分支中存在未合并提交，但仍需要强制删除

git merge <branch>#

将指定分支合并到当前分支。

例如：

1
git switch master
2
git merge dev

执行前：

1
A---B---C
2
     \
3
      D---E
4

5
master -> C
6
dev    -> E

普通合并后：

1
A---B---C-------M
2
     \         /
3
      D-------E
4

5
master -> M
6
dev    -> E

其中 M 为 Merge Commit。

适用场景：

• 将功能分支合并到主分支
• 将上游分支更新合并到当前分支
• 保留分叉和合并历史

Fast-forward Merge#

如果当前分支之后没有新的独立提交，Git 可能直接移动分支指针。

执行前：

1
A---B---C---D---E
2
        ↑       ↑
3
     master    dev

执行：

1
git switch master
2
git merge dev

执行后：

1
A---B---C---D---E
2
                ↑
3
           master, dev

git merge --no-ff <branch>#

即使可以 Fast-forward，也强制创建 Merge Commit。

1
git merge --no-ff dev

执行前：

1
A---B---C---D---E
2
        ↑       ↑
3
     master    dev

执行后：

1
A---B---C-------M
2
         \     /
3
          D---E

适用场景：

• 需要明确保留一次分支合并记录

git rebase <branch>#

将当前分支上的提交重新应用到指定分支之后。

1
git switch dev
2
git rebase master

执行前：

1
A---B---C
2
     \
3
      D---E
4

5
master -> C
6
dev    -> E

执行后：

1
A---B---C---D'---E'
2
        ↑         ↑
3
     master      dev

适用场景：

• 将开发分支更新到较新的基础分支之上
• 保持提交历史为线性结构

git cherry-pick <commit>#

将指定提交的修改应用到当前分支，并创建一个新的提交。

执行前：

1
A---B---C
2
     \
3
      D---E---F
4

5
master -> C
6
dev    -> F

执行：

1
git switch master
2
git cherry-pick <E的CommitID>

执行后：

1
A---B---C---E'
2
     \
3
      D---E---F

适用场景：

• 只需要另一个分支中的一个或几个提交
• 将某个 Bug 修复单独应用到其他分支

git reset --soft <commit>#

移动当前分支到指定提交，并保留之后的修改在暂存区。

执行前：

1
A---B---C
2
        ↑
3
      master

执行：

1
git reset --soft HEAD~1

执行后：

1
A---B
2
    ↑
3
  master

C 中的修改仍处于暂存状态。

适用场景：

• 撤销最近一次提交，但保留已暂存的修改

git reset --mixed <commit>#

移动当前分支到指定提交，并将之后的修改保留在工作区。

1
git reset --mixed HEAD~1

也可以省略 --mixed：

1
git reset HEAD~1

执行后，修改不会处于暂存状态。

git reset --hard <commit>#

移动当前分支，并同步修改暂存区和工作区。

1
git reset --hard HEAD~1

执行前：

1
A---B---C---D---E
2
                ↑
3
             master

执行：

1
git reset --hard C

执行后：

1
A---B---C
2
        ↑
3
      master

git remote add <name> <url>#

添加新的远程仓库。

1
git remote add upstream https://github.com/official/project.git

常见名称：

1
origin    自己克隆或推送使用的远程仓库
2
upstream  上游仓库

git remote -v#

查看所有远程仓库地址。

1
git remote -v

示例：

1
origin    git@github.com:user/project.git (fetch)
2
origin    git@github.com:user/project.git (push)
3
upstream  git@github.com:official/project.git (fetch)
4
upstream  git@github.com:official/project.git (push)

git fetch <remote>#

从指定远程仓库获取最新提交和引用，但不自动修改当前本地分支。

1
git fetch upstream

执行前：

1
本地：
2

3
A---B---C
4
        ↑
5
 upstream/master
6

7
远程：
8

9
A---B---C---D---E

执行后：

1
A---B---C---D---E
2
                ↑
3
       upstream/master

适用场景：

• 获取远程最新状态
• 合并或 Rebase 前先检查远程更新

git pull#

获取当前分支上游远程的更新，并合并到当前分支。

1
git pull

对应命令：

1
git fetch
2
git merge

git pull <remote> <branch>#

从指定远程分支获取并合并。

1
git pull origin master

git pull --rebase#

获取远程更新后，以 Rebase 方式更新当前分支。

1
git pull --rebase

执行前：

1
A---B---C---D
2
        \   ↑
3
         \ origin/master
4
          E---F
5
              ↑
6
            master

执行后：

1
A---B---C---D---E'---F'
2
            ↑         ↑
3
      origin/master master

git push <remote> <branch>#

将本地分支推送到远程仓库。

1
git push origin master

git push -u <remote> <branch>#

首次推送分支，并建立上游跟踪关系。

1
git push -u origin dev

建立：

1
本地 dev
2
   ↓
3
origin/dev

1
git push

或：

1
git pull

git branch --set-upstream-to=<remote>/<branch>#

为当前分支设置上游分支。

1
git branch --set-upstream-to=origin/master

指定本地分支：

1
git branch --set-upstream-to=origin/master master

git branch --unset-upstream#

取消当前分支的上游跟踪关系。

1
git branch --unset-upstream

git push <remote> --delete <branch>#

删除远程仓库中的分支。

1
git push origin --delete dev

执行前：

1
origin/master
2
origin/dev

执行后：

1
origin/master

git merge --abort#

取消当前正在进行的合并。

1
git merge --abort

适用场景：

• 合并发生冲突
• 不准备继续本次合并

git merge --continue#

冲突解决并暂存后继续合并。

1
git add <file>
2
git merge --continue

部分情况下也可以直接执行：

1
git commit

完成合并。

git rebase --continue#

解决冲突并暂存后继续 Rebase。

1
git add <file>
2
git rebase --continue

git rebase --skip#

跳过当前无法应用的提交。

1
git rebase --skip

git rebase --abort#

取消整个 Rebase 操作，并恢复到开始前的状态。

1
git rebase --abort

git cherry-pick --continue#

解决冲突后继续 Cherry-pick。

1
git add <file>
2
git cherry-pick --continue

git cherry-pick --abort#

取消当前 Cherry-pick。

1
git cherry-pick --abort

git stash#

临时保存当前工作区修改。

1
git stash

适用场景：

• 当前存在未提交修改，但需要切换分支
• 合并或 Rebase 前临时清理工作区

git stash push -m <message>#

保存修改并添加说明。

1
git stash push -m "WIP: temporary changes"

git stash list#

查看 Stash 列表。

1
git stash list

git stash pop#

恢复最近一次 Stash，并将其从 Stash 列表移除。

1
git stash pop