GIT常用命令解析

术语

工作区/work tree
仓库所在的文件夹叫做工作区,就是你在电脑里能看到的目录。
暂存区
也就是在git add之后,git commit之前的缓冲区,一般在.git/index文件中。
仓库
git commit之后,根据暂存区的文件生成一个commit id,暂存区的文件归档到仓库中,一般在.git/objects里面

git

# 输出git版本信息
$ git -v
git version 2.38.1.windows.1

# 输出常用的命令列表
$ git -h

# 用于临时配置 Git 的配置选项。
# 临时把commit id长度限制为 7 个字符
$ git -c log.abbrevCommit=true -c log.abbrevCommitLength=7  log

git config

# 全局修改配置
$ git config --global user.email=you@example.com
$ git config --global user.name=Your Name
# 获取某个配置项的值
$ git config user.name
# 列出所有配置项
$ git config --list
$ 删除某个配置项
$ git config --unset --global user.name

git init

# 初始化一个新的git仓库
$ git init

git clone 克隆远程仓库

# 克隆远程仓库到本地文件夹my-linux
$ git clone git://git.kernel.org/pub/scm/.../linux.git my-linux

$ 初始化一个纯版本仓库,没有工作区。用于创建远程仓库
$ git init --bare

git add

对于将工作区的修改添加到暂存区非常重要,只有暂存过的修改才能被git commit提交到仓库

# 添加指定的文件到暂存区,可以用正则匹配
$ git add <file>
$ git add git-*.sh
# 添加当前目录下所有文件到暂存区
$ git add . 
# 添加之前已经被git管理的文件到暂存区
$ git add -u
# 添加之前被git忽略的文件到暂存区
$ git add -f <file>

git status

可以清楚地了解工作区和暂存区的文件变化情况

# 显示详细的修改状态
$ git status 
# 以短格式显示状态,更简洁
$ git status -s 
# 顺便显示当前分支名
$ git status -b
# 显示忽略的文件
$ git status --ignored

git diff

能够显示各个区域之间的差异,理解其返回结果对于分析版本变化和调试非常重要

# 显示工作区与暂存区的差异。
$ git diff 
# 显示暂存区与仓库的差异
$ git diff --staged 
$ git diff --cached
# 显示工作区与仓库的差异
$ git diff HEAD
# 显示两个提交之间的差异
$ git diff 02d1a7b d2974d6
# 显示两个分支之间的差异。
$ git diff dev master
# 导出差异文件成压缩包
$ git diff --name-only   144d196 188df06a | xargs tar -cvf pacakge.tar.gz

git commit

# 提交暂存区的修改,并添加提交信息,生成commit id
$ git commit -m "message"
# 提交工作区和暂存区的所有修改,不包含新建的文件
$ git commit -am "message"
# 修改最后一次提交的信息
$ git commit --amend
# 绕过钩子程序
$ git commit --no-verify
# 允许空白提交,git tag可能会用到
$ git commit --allow-empty

git notes

非常适合用来为提交添加额外的评论信息,这些信息存储在.git/notes目录中

# 添加注释信息到指定提交,如果不指定提交则默认为HEAD
$ git notes add -m "This is a note"  7d68213
# 删除指定提交的注释信息
$ git notes remove 7d68213    
# 显示指定提交的注释信息,如果不指定提交则默认为HEAD
$ git notes show 7d68213
# 显示全部的注释信息
$ git notes list
# 编辑指定提交的注释信息
$ git notes edit 7d68213

git restore

可以用于回滚工作区和暂存区的修改,将文件恢复到指定状态,非常适合于版本控制和修改回退。

# 放弃对工作区文件的修改,恢复到仓库HEAD的状态,可用正则匹配
$ git restore hello.c                   
$ git restore '*.c'
$ git restore .
# 恢复工作区文件到指定提交的状态
$ git restore --source 7d68213 hello.c
$ git restore -s 7d68213 hello.c
# 仅恢复暂存区的文件到HEAD状态,不影响工作区,相当于撤销git add hello.c操作
$ git restore --staged hello.c

git reset

用于重置当前分支的HEAD为指定状态,它会改变reflog和仓库历史。

# 重置HEAD为指定提交,重置暂存区但保留工作区修改
$ git reset 7d68213
$ git reset --mixed 7d68213
# 重置HEAD为指定提交,但保留工作区修改
$ git reset --soft 7d68213
# 回滚HEAD两个版本,但保留工作区修改
$ git reset --soft HEAD~2
# 重置HEAD为指定提交,重置暂存区和工作区,丢弃所有修改
$ git reset --hard dc7ccb1
# 重置时保留未跟踪文件。
$ git reset --mixed --keep 2d3a2b9

git rm

用于从git中删除文件。它会将文件从工作区和暂存区移除,并且提交修改,使文件从仓库中永久删除

# 删除指定文件,并提交移除操作到暂存区,删除前会检查文件状态,以免误删未提交的修改。
$ git rm index.php
# 删除指定文件,并提交移除操作到暂存区,删除前不会检查文件状态
$ git rm -f index.php
# 删除暂存区和仓库中的文件,但保留工作区中的文件
$ git rm --cached xx.log
# 递归删除整个目录
$ git rm -r runtime/
# 删除目录中的所有文件的暂存区和仓库版本,但保留工作区中的文件,一般用于.gitignore文件添加.idea文件夹时,把.idea从暂存区和仓库删掉同时保留工作区文件
$ git rm -r --cached .idea/

git mv

用于移动或重命名文件和目录。它实际上是git rm和git add的组合,用于跟踪文件移动和重命名

# 移动/重命名文件或目录 <source> 为 <destination>
$ git mv index.php index.php.bak

git branch

用于列出、创建和删除分支

# 列出本地所有分支
$ git branch
# 创建本地新分支
$ git branch feature/devlop
# 删除本地分支,只能删除已合并的分支,或者HEAD和master一致的分支(还没commit过)
$ git branch -d feature/devlop
# 删除本地分支,可以删除未合并的分支
$ git branch -D feature/devlop
# 列出本地分支及其最后一个提交
$ git branch -v
# 列出本地已经合并到当前分支的分支
$ git branch --merged
# 列出尚未合并到当前分支的分支
$ git branch --no-merged
# 列出本地和远程所有分支
$ git branch -a
# 重命名分支
$ git branch -m master main
# 复制一个分支到新创建的分支上,拥有前分支完整的历史
$ git branch -c new_branch
# 将本地分支与指定的远程分支建立追踪关系。
$ git branch --set-upstream-to main main
# 删除对远程分支的追踪设置。
$ git branch --unset-upstream new_branch
# 从 c83c925f6 提交处创建新的分支。
$ git branch test c83c925f6

git checkout

用于切换分支或恢复工作区文件

# 切换到指定分支
$ git checkout master:切换到指定分支
# 创建新分支并切换到该分支
$ git checkout -b develop
# 丢弃工作区的修改,恢复与暂存区一致的版本
$ git checkout -- index.php
# 工作区中文件的版本回滚到仓库指定提交
$ git checkout cdc5737 -- index.php
# 切换到指定tag所指向的提交,配合rebase使用可以在重要的标记状态继续工作,同时不必担心丢失之前的提交
$ git checkout v1.0

git switch

git 2.23版本新增的命令,用于切换分支或恢复工作区文件

# 切换到master分支
$ git switch master  
# 创建并切换到新分支new-feature 
$ git switch -c new-feature  
# 删除已合并的分支 
$ git switch -d old-feature
# 强制切换,重置工作区
$ git switch -f master 
# 创建空分支  
$ git switch --orphan new-branch

git merge

用于将两个或多个开发历史合并在一起

# 将指定分支 develop 合并到当前分支,如果可以快进则快进,如果不能快进则创建一个新的合并提交,保留完整的分支记录
# 快进指的是如果develop HEAD是master HEAD的上游,则可以直接把master HEAD改成develop HEAD
$ git merge develop
# 禁用快进,创建一个新的合并提交,即使可以进行快进合并,保留完整的分支记录,常用于开发阶段
$ git merge --no-ff develop
# 仅在可以进行快进合并时才会合并指定分支
$ git merge --ff-only develop
# 将指定分支 develop 的多个提交压缩到一个提交,合并到当前分支的暂存区,需要手动提交
$ git merge --squash develop
# 执行合并但不创建提交,需要手动提交
$ git merge --no-commit develop

git mergetool

用于调解merge冲突的命令,在发生merge冲突时,直接运行

# 指定使用哪个工具调解冲突
$ git mergetool --tool=vimdiff
$ git mergetool --tool=kdiff3
$ git mergetool --tool=meld

git log

用于查看提交历史

# 显示最近两次提交
$ git log -2
# 显示某个作者的提交日志 
$ git log --author="ben"
# 显示某个日期范围内的提交 
$ git log --since=1.month --until="2018-02-28"
# 显示包含某个关键词的提交
$ git log --grep="README"
# 显示某个文件被修改的历史 
$ git log --follow README.md
# 一条命令显示简洁日志、分支和版本标签
$ git log --oneline --decorate --all --graph
# 显示提交统计信息 
$ git log --stat
# 显示某个tag到当前提交的日志 
$ git log v1.0.0..HEAD
# 显示某个tag和最后一个tag之间的所有提交
git log v1.0.0..v1.2.1
# 显示某个分支的日志
$ git log master

git stash

用于临时存储和还原未提交的工作
当你在某个分支开发某个新的特性,代码还在工作区,突然需要切换到另一个分支解决一个bug,如果直接切换分支可能会提示代码会被覆盖

error: Your local changes to the following files would be overwritten by checkout:
    ttt
Please commit your changes or stash them before you switch branches.

需要你先提交再切换分支,然后你因为代码没有完成各种原因并不想提交,这个时候就可以用git stash,具体操作如下

git stash保存当前工作进度
切换分支并修复Bug
git stash pop恢复工作进度
继续开发新特性

# 显示所有存储的stash,可以使用git stash apply恢复指定的stash。
$ git stash list
# 显示指定stash的更改信息,不恢复stash。
$ git stash show stash@{0}
# 以补丁的形式显示更改信息。
$ git stash show -p
# 恢复指定的stash到一个新分支上。
$ git stash branch new_branch
# 恢复最近一次的stash,并从stash list中移除它。
$ git stash pop
# 从stash list中移除一个stash,不会恢复它。
$ git stash drop
# 清除所有stash。
$ git stash clear
# 恢复指定的stash,但是不从stash list中移除它,可以用于测试恢复效果。
$ git stash apply stash@{0}
# 保存当前工作并添加注释,便于之后查找恢复。
$ git stash save "some comments"
# 交互式地选择要暂存的更改部分,不保存全部的工作进度。
$ git stash save --patch
# 只暂存已经添加至暂存区的更改,未添加的更改不会被暂存。
$ git stash save --keep-index

git tag

用于创建和管理标签,可以给项目的重要历史提交打上标签,以示重要的发布版本或里程碑

# 打一个轻量级标签
$ git tag v1.0
# 打一个带注释的标签
$ git tag -a v2.0 -m "Release version 2.0"
# 给过去的某次提交打标签
$ git tag -a v1.1 9fa1799
# 查看v1.1的标签信息和提交信息
$ git show v1.1
# 从标签v1.1创建新分支
$ git checkout -b release-v1.1 v1.1
# 删除本地标签v1.1
$ git tag -d v1.1
# 推送单个新标签到远程
$ git push origin v1.0
# 推送所有新标签到远程
$ git push origin --tags
# 删除远程标签
$ git tag -r <tagname>

git worktree

用于管理同一仓库的多个工作树

需要用到再研究@todo

git fetch

将远程仓库的最新提交下载到本地,但是不会自动合并到当前分支。这意味着使用fetch获取的数据需要手动merge到本地分支之后才会生效

# 获取所有远程仓库最新提交:
$ git fetch --all
# 查看本地和远程仓库差异,然后合并
$ git log origin/dev..dev
$ git diff origin/dev dev
$ git merge

# 只获取origin远程仓库master分支的最新两个提交
$ git fetch origin master --depth 2
# 获取origin远程仓库,并清除服务器上已经删除的分支
$ git fetch --prune origin
# 将一个浅仓库转为完整仓库:
$ git fetch --unshallow
# 预览将要获取的提交,但不实际获取
$ git fetch --dry-run

git pull

用于从远程仓库获取最新数据后与本地当前分支自动合并,实际上是git fetch和git merge的组合

# 从origin远程仓库获取master分支并合并: 
$ git pull origin master
# 使用rebase合并:
$ git pull --rebase
# 只在可以快速向前合并的情况下进行合并:
$ git pull --ff-only
# 从所有远程仓库获取数据并合并: 
$ git pull --all
# 删除远程仓库origin并更新引用:
$ git pull -d origin
# 拉取远程仓库的标签
$ git pull --tags

git push

将本地提交推送到远程仓库,与其他协作者分享同步工作成果

# 推送master分支到origin远程仓库: 
$ git push origin master
# 推送全部本地分支到origin:
$ git push origin --all
# 删除远程仓库origin的dev分支:
$ git push origin --delete dev
# 强制推送master分支到origin,会覆盖远程分支:
$ git push origin master --force
# 只有在远程master分支是当前master分支的上游分支时,才强制推送:
$ git push origin master --force-with-lease
# 推送所有标签到远程仓库
$ git push <remote> --tags

git remote

用于管理远程仓库的别名,从而指定不同的远程仓库及其URL。Git支持为同一个仓库添加多个远程仓库。可以通过多次运行git remote add命令添加多个远程仓库别名,并指定不同的仓库URL。

git remote add origin https://github.com/user/repo.git
git remote add upstream https://gitlab.com/user/repo.git 
git remote add alias https://bitbucket.org/user/repo.git

# 列出当前所有的远程仓库别名
$ git remote
# 添加一个新的远程仓库origin,URL为https://github.com/user/repo.git
$ git remote add origin https://github.com/user/repo.git
# 重命名远程仓库upstream为up
$ git remote rename upstream up
# 移除远程仓库up
$ git remote remove up
# 修改远程仓库origin的URL
$ git remote set-url origin https://gitee.com/user/repo.git
# 列出远程仓库origin的详细信息
$ git remote show origin

git submodule

主要用于管理仓库内嵌套的子模块。
子模块允许我们将一个仓库当作另一个仓库的子目录,这个子目录又是一个完整的仓库。
这样,我们可以独立开发子模块中的项目,同时在主项目中可以指定相应提交记录。
当克隆仓库时,需要运行git submodule init和git submodule update以初始化子模块及其历史。

git show

可以让我们查看某次提交的所有细节,包括提交信息、修改的文件、各文件差异等。
这在开发和调试代码过程中非常有用,可以快速定位引入某个问题的提交,检查相关文件变化等。

# 显示HEAD指向的提交信息
$ git show
# 显示master分支的最新提交815e1c2的信息
$ git show 815e1c2
# 仅显示该提交修改的文件列表
$ git show 815e1c2 --name-only
# 显示该提交的文件差异 
$ git show 815e1c2 -p
# 以medium格式显示提交信息
$ git show 815e1c2 --pretty=medium
# 显示要应用提交815e1c2,需要运行的cherry-pick命令
$ git show 815e1c2 --cherry-pick

git shortlog

用于简洁地浏览提交日志,方便查看贡献者的提交,git log的简洁版

# 显示所有提交的简要日志,按提交者排序
$ git shortlog
# 仅显示最近10次提交
$ git shortlog -n 10
# 显示提交者和提交次数的汇总,不显示提交摘要
$ git shortlog -s
# 显示所有提交者的邮箱和提交SHA-1校验和
$ git shortlog -e --all

git describe

根据最近的标签来描述未打标签的提交
在持续集成或开发过程中,经常需要知道当前代码距离最后一个发布标签的提交次数,以判断当前进度或是否需要发布新版本。
此时,可以使用git describe快速获取这一信息,例如:

# 表示当前提交g6145309距离标签v1.2.3有5次提交。
$ git describe
v1.2.3-5-g6145309

git apply

将补丁文件的更改应用到当前的Git树对象或工作树上,这在版本升级、临时测试补丁效果以及分发开发组内的修补等方面非常有用

# 应用0001-fix-bug.patch补丁
$ git apply 0001-fix-bug.patch
# 仅显示应用该补丁后文件的变化统计:
$ git apply --stat 0001-fix-bug.patch
# 检查补丁是否可以应用成功:
$ git apply --check 0001-fix-bug.patch
# 应用补丁,更新索引而非工作树
$ git apply --cached 0001-fix-bug.patch
# 反转补丁的更改
$ git apply --reverse 0001-fix-bug.patch
# 在无法应用的部分中创建reject文件
$ git apply --reject 0001-fix-bug.patch

git cherry-pick

用于将指定提交的更改应用到当前分支,这与git merge的效果类似。
但是,cherry-pick会记录为一个全新的提交,而非合并提交。
git cherry-pick是一个高级工具,可以通过应用特定提交的更改来调整项目的开发进展。
但是,如果对其原理不太清晰,反而可能产生许多无意义的提交,破坏提交历史的整洁性。

# 应用master分支的最近3次提交
$ git cherry-pick master~3..master
# 记录为新的提交,而非应用指定提交
$ git cherry-pick -x 8fd4e43
# 编辑提交信息后进行提交:
$ git cherry-pick -e 8fd4e43
# 不进行提交,仅更新工作树
$ git cherry-pick -n 8fd4e43
# 应用提交更改,不创建新的提交:
$ git cherry-pick --no-commit 8fd4e43
# 使用ours合并策略应用提交
$ git cherry-pick -Xours 8fd4e43

git rebase

git rebase用于将指定分支的变更重新定位到另一个分支上,可以看作是”变基”。
它会取消指定分支的所有提交,并将其内容应用到另一分支上,出现新的提交记录。
git rebase是一个高级工具,可以使提交历史变得更加整洁。
但是,如果在公开分享的分支上使用,可能会对其他开发者产生影响。

# 将experiment分支rebase到master分支  
$ git checkout experiment 
$ git rebase master
# 交互式rebase,合并最近3次提交  
$ git rebase -i HEAD~3
# 继续rebase操作  
$ git rebase --continue  
# 终止rebase操作  
$ git rebase --abort

git revert

git revert用于创建一个新的提交来撤销指定提交的更改。
它会创建一个全新的提交,回滚指定的提交,但是不会修改提交历史,线上仓库需要回滚的时候可以用revert取代reset,避免了git push -f强推的操作

# 撤销最近一次提交 
$ git revert HEAD
# 撤销指定的提交 
$ git revert 8fd4e43
# 编辑revert信息
$ git revert -e 8fd4e43
# 撤销指定提交,不记录revert到操作
$ git revert --no-commit 8fd4e43

git reflog

reset回滚之后,以前的提交就不会显示在git log里面了,找不到提交id就没办法reset回来,可以在reflog查到分支变更记录

# 查找master最近5次变更
$ git reflog show master | head - 5
750c435 (HEAD -> master) master@{0}: commit: xx
2d3a2b9 (tag: v1.0) master@{1}: reset: moving to 2d3a2b9d
dc7ccb1 master@{2}: reset: moving to dc7ccb1
2d3a2b9 (tag: v1.0) master@{3}: reset: moving to 2d3a2b9dc

# 回滚到master两次改变之前的commit,git log也会恢复
$ git reset --hard master@{2}

git cat-file

用于获取git对象的内容、类型和长度信息

# 显示提交对象a6be41的内容
$ git cat-file -p a6be41
# 显示提交对象a6be41的类型
$ git cat-file -t a6be41
# 显示提交对象a6be41的大小
$ git cat-file -s a6be41
# 显示提交对象a6be41的头信息
$ git cat-file -e a6be41
# 显示多个对象(a6be41,cat-file, 9fceb46)的类型
$ git cat-file --batch-check=type a6be41 cat-file 9fceb46