# Git 常用命令集合

git 常用命令

Git 常用命令集合，Fork 于tips项目

Git 是一个“分布式版本管理工具”，简单的理解版本管理工具：大家在写东西的时候都用过“回撤”这个功能，但是回撤只能回撤几步，假如想要找回我三天之前的修改，光用“回撤”是找不回来的。而“版本管理工具”能记录每次的修改，只要提交到版本仓库，你就可以找到之前任何时刻的状态（文本状态）。

下面的内容就是列举了常用的 Git 命令和一些小技巧，可以通过"页面内查找"的方式进行快速查询：Ctrl/Command+f。

# 开卷必读

如果之前未使用过 Git，可以学习猴子都能懂的 GIT 入门

统一概念:

工作区：本地电脑存放项目文件的地方，比如 learnGitProject 文件夹；

暂存区：暂存区（Index/Stage）：在使用 git 管理项目文件的时候，其本地的项目文件会多出一个.git 的文件夹，将这个.git 文件夹称之为版本库。其中.git 文件夹中包含了两个部分，一个是暂存区（Index 或者 Stage）,顾名思义就是暂时存放文件的地方，通常使用 add 命令将工作区的文件添加到暂存区里；

本地仓库(简称：本地)：.git 文件夹里还包括 git 自动创建的 master 分支，并且将 HEAD 指针指向 master 分支。使用 commit 命令可以将暂存区中的文件添加到本地仓库中；。

远程仓库(简称：远程)：不是在本地仓库中，项目代码在远程 git 服务器上，比如项目放在 github 上，就是一个远程仓库，通常使用 clone 命令将远程仓库拷贝到本地仓库中，开发后推送到远程仓库中即可；

commit-id：输出命令：git log，最上面那行commit xxxxxx，后面的字符串就是 commit-id

# 基本操作

# git 设置和取消代理解决 push 和 clone 无法进行的问题

# 设置ss
git config --global http.proxy 'socks5://127.0.0.1:1080'

git config --global https.proxy 'socks5://127.0.0.1:1080'

# 设置代理
git config --global http.proxy http://127.0.0.1:1080

git config --global https.proxy https://127.0.0.1:1080

# 取消代理
git config --global --unset http.proxy

git config --global --unset https.proxy

# 有时候上面的取消代理不起作用，可以使用
git config --global --unset remote.origin.proxy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# Github 进行 fork 后如何与原仓库同步

查看远程仓库

git remote -v

配置原仓库的路径

git remote add upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git

git remote -v

抓取原仓库的修改文件

git fetch upstream

切换到 master 分支

git checkout master

合并远程的 master 分支

git merge upstream/master

此时本地库与原仓库已经同步，之后把本地仓库 push 到远程仓库即可。

git push origin

https://blog.csdn.net/matrix_google/article/details/80676034

# 回退操作

git 版本最重要的功能之一就是回退版本了。

reset
cherry-pick
revert

rebase

# 合并操作

# 设置大小写不敏感

git config core.ignorecase false

# 展示帮助信息

git help -g

# 创建数据库

git init

# 添加文件或目录到索引

在 filepattern 可以直接指定文件名。此外，也可以指令通配字符 ( 例如“*.txt” )。如果指令 ".” , 可以将子目录里的所有文件添加到索引。

添加-p 选项，就可以只添加文件修改的其中一部分。如果添加 -i 选项，那么可以选择用对话形式显示添加在索引的文件。

git add <filepattern>

# 提交追加到索引的文件

# GIS 设定

# 显示设定清单

git config --global --list

# 删除全局设置

git config --global --unset <entry-name>

# 输出彩色

git config --global color.ui auto

# 设定用户名/电子邮件地址

如果不添加--global 选项，此设定只对该数据库有效。

git config --global user.name "username"

git config --global user.email "email"

1
2
3

# 查看全局的用户名和邮箱

git config --global user.name

git config --global user.email

1
2
3

# 查看 git 配置

在项目的根目录下，输入

# 打开 .git 目录
cd .git

# 查看里面的文件

ls

# 打开 config 文件
vi config

1
2
3
4
5
6
7
8
9

# 给 git 命令起别名

简化命令

git config --global alias.<handle> <command>

比如：git status 改成 git st，这样可以简化命令

git config --global alias.st status

1
2
3
4
5

# 把不需要用的文件归类到非管理对象

记录为.gitignore 的文件是 Git 的非管理对象，但是需要提交.gitignore 本身。

$ echo <filename> >> .gitignore

# https 连接 push 不输入密码

直接配置 config 配置文件不需要每次输入密码

vim .git-credentials
输入 https://{username}:{password}@github.com
git config --global credential.helper store

# 手把手教你设置 SSH 连接

SSH key 可以让你在你的电脑和 Git 远程仓库之间建立安全的加密连接。

# Mac

ssh-keygen

接着会显示以下的内容输出，在有需要的地方输入设定验证密码的文字，然后按“Enter”键。

如果不设定验证密码，请不要输入任何文字，直接按“Enter”键即可。

执行下一个命令就可以确认形成 SSH 键公钥的内容。

cat ~/.ssh/id_rsa.pub

接下来，在远程数据库设定公钥。

# window

先下载 cmder 命令行（linux）工具，之后跟 mac 一样的命令行操作即可。

# ⚠️ 在本地配置多个 SSH-Key

10分钟教你本地配置多个 git ssh 连接

# 回到远程仓库的状态

抛弃本地所有的修改，回到远程仓库的状态。

git fetch --all && git reset --hard origin/master

# 展示工作区和暂存区的不同

输出工作区和暂存区的 different(不同)。

git diff

还可以展示本地仓库中任意两个 commit 之间的文件变动：

git diff <commit-id> <commit-id>

# 展示暂存区和最近版本的不同

输出暂存区和本地最近的版本(commit)的 different(不同)。

git diff --cached

# 展示暂存区、工作区和最近版本的不同

输出工作区、暂存区 和本地最近的版本(commit)的 different(不同)。

git diff HEAD

# 操作分支

# 创建并切换到本地分支

git checkout -b <branch-name>

# 创建并切换到远程分支

git checkout -b <branch-name> origin/<branch-name>

# 删除本地分支

git branch -d <local-branchname>

# 删除远程分支

git push origin --delete <remote-branchname>

或者

git push origin :<remote-branchname>

# 重命名本地分支

git branch -m <new-branch-name>

# 快速切换分支

git checkout -

# 删除已经合并到 master 的分支

git branch --merged master | grep -v '^\*\|  master' | xargs -n 1 git branch -d

# 展示本地分支关联远程仓库的情况

git branch -vv

# 关联远程分支

关联之后，git branch -vv就可以展示关联的远程分支名了，同时推送到远程仓库直接：git push，不需要指定远程仓库了。

git branch -u origin/mybranch

或者在 push 时加上-u参数

git push origin/mybranch -u

# 列出所有远程分支

-r 参数相当于：remote

git branch -r

# 合并分支

在 git 中合并分支有三种方法，分别是 merge，rebase，cherry-pick，而其中 merge 又有三种区别 https://yanhaijing.com/git/2017/07/14/four-method-for-git-merge/

# merge

如果添加 --no-ff 选项，就是 fast-forward 合并也可以建立合并提交。这是记录分支存在过的非常有用的选项。考虑一下“功能”分支上的一系列次要提交共同构成一个新功能的情况：如果你只是在没有--no-ff 的情况下执行“git merge feature_branch”，那么就不可能从 Git 历史中看到哪一个提交对象一起实现了一个功能 - 您必须手动读取所有日志消息。好处就是 GUI 界面可以直观看到信息。

git merge <branch>

# cherry-pick

这命令简直就是神器，给你自由，你想把那个节点 merge 过来就把那个节点 merge 过来，其合入的不是分支而是提交节点

git cherry-pick commitId

# rebase

rebase 作用简要为：可以对某一段线性提交历史进行编辑、删除、赋值、粘贴，合理适应 rebase 命令可以让我们的提交历史干净、简介注意：不要通过 rebase 对任何已经提交到公共仓库中的 commit 进行修改（你自己一个人玩的分支除外）

# 合并多个 commit 为一个完整的 commit

git rebase -i [startponit] [endpoint]

其中 -i 意思是 --ineractive，即弹交互式的界面让用户编辑完成合并操作，[startponit] endpoint 指定了一个编辑区间。如果不指定 [endponit] 则该区间的默认是当前分支 HEAD 所指向的 commit.

# 将某一段 commit 粘贴到另外一个分支上

参考资料：rebase 用法小结

# 从其他分支合并指定文件或文件夹

功能分为 2 个分支，分别为 A、B。 A 上面有个列表页功能 B 上面有个详情页功能，还有个系统消息功能

产品经理说先上列表功能，于是我们就开发 A 分支，列表功能很快开发完成。第二天按常理开发 B 分支，开发到一半，产品经理说目前的系统消息功能需要急着上线，要和列表功能一起上线，当时就懵逼了，然后赶紧放下详情页的开发，立马去开发系统消息功能，开发完之后需要将列表功能和系统消息功能放在一个分支上提测，这时候分支合并就派上用场了。

使用 git merge 命令进行分支合并是通用的做法，但是 git merge 合并的时候会将两个分支的内容完全合并，如果想合并一部分肯定是不行的。那怎么办？

如何从其他分支 merge 指定文件到当前分支，git checkout 是个合适的工具。

git checkout source_branch <path>...

强制合并

git branch 当前位于 A 分支上
  * A
    B
# 在使用git checkout某文件到当前分支时，会将当前分支的对应文件强行覆盖
git checkout B xxx.html xxx.js

1
2
3
4
5

智能合并

使用 git checkout 将根据 A 分支创建一个 A_temp 分支，避免影响 A 分支

git checkout -b A_temp

将 B 分支合并到 A_temp 分支

git merge --no-ff B

切换到 A 分支，并使用 git checkout 将 A_temp 分支上的系统消息功能相关文件或文件夹覆盖到 A 分支

$ git checkout A
Switched to branch 'A'

$ git checkout A_temp message.html message.css message.js other.js

1
2
3
4

# 列出本地和远程分支

-a 参数相当于：all

git branch -a

# 以最后提交的顺序列出所有 Git 分支

# stash

# 存储当前的修改，但不用提交 commit

详解可以参考廖雪峰老师的 git 教程

git stash

git stash 命令可以暂存我们的所有文件，但有时我只想要存储部分的文件，这个时候可以用 git stash -p命令，这个命令可以决定要暂存哪些文件。有时候 git stash 了好几次，然后看 git stash 的 list 的时候，不记得哪个是我们想要找的那一次 git stash 了，可以在 git stash 的时候添加备注 git stash save "save message" ，这样下次就可以找到我们想要的那一次 stash 了。

# 展示所有 stashes

git stash list

# 回到某个 stash 的状态

git stash apply <stash@{n}>

# 保存当前状态，包括 untracked 的文件

untracked 文件：新建的文件

git stash -u

# 回到最后一个 stash 的状态，并删除这个 stash

git stash pop

# 删除所有的 stash

git stash clear

# 从 stash 中拿出某个文件的修改

git checkout <stash@{n}> -- <file-path>

# 操作标签

tag 就是一个只读的 branch，一般为每一个可发布的里程碑版本打一个 tag。

tag 的存在，是因为我们需要这种标记的功能。目前的项目开发中，当发布版本时 tag 就派上用场了。例如 v1.0.1，v1.0.2… 另外，git 提供了 tag 的增删改查一系列操作。

ag 和 branch 的区别以及使用场景？想到这里，你可能觉得 tag 和 branch 有点相似。没错，的确是有点像，但是它们的职责分工和本质都是不同的。 tag 对应某次 commit, 是一个点，是不可移动的。 branch 对应一系列 commit，是很多点连成的一根线，有一个 HEAD 指针，是可以依靠 HEAD 指针移动的。

所以，两者的区别决定了使用方式，改动代码用 branch ,不改动只查看用 tag。

tag 和 branch 的相互配合使用，有时候起到非常方便的效果，例如已经发布了 v1.0 v2.0 v3.0 三个版本，这个时候，我突然想不改现有代码的前提下，在 v2.0 的基础上加个新功能，作为 v4.0 发布。就可以检出 v2.0 的代码作为一个 branch ，然后作为开发分支。然后再根据需要重新打一个 tag。

https://www.liaoxuefeng.com/wiki/896043488029600/900788941487552

# 本地创建标签

git tag <version-number>

默认 tag 是打在最近的一次 commit 上，如果需要指定 commit 打 tag：

$ git tag -a <version-number> -m "v1.0 发布(描述)" <commit-id>

# 删除本地标签

git tag -d <tag-name>

# 查看标签

git tag

展示当前分支的最近的 tag

git describe --tags --abbrev=0

# 推送标签到远程仓库

首先要保证本地创建好了标签才可以推送标签到远程仓库：

git push origin <local-version-number>

一次性推送所有标签，同步到远程仓库：

git push origin --tags

# 删除远程标签

删除远程标签需要先删除本地标签，再执行下面的命令：

git push origin :refs/tags/<tag-name>

# 切回到某个标签

一般上线之前都会打 tag，就是为了防止上线后出现问题，方便快速回退到上一版本。下面的命令是回到某一标签下的状态：

git checkout -b branch_name tag_name

# 放弃工作区的修改

git checkout <file-name>

放弃所有修改：

git checkout .

# 恢复删除的文件

git rev-list -n 1 HEAD -- <file_path> #得到 deleting_commit

git checkout <deleting_commit>^ -- <file_path> #回到删除文件 deleting_commit 之前的状态

1
2
3

# 改写提交

# 恢复 git reset --hard 的误操作

有时候使用 Git 工作得小心翼翼，特别是涉及到一些高级操作，例如 reset, rebase 和 merge。甚至一些很小的操作，例如删除一个分支，我都担心数据丢失。

git 的历史记录是不可修改的，也就是说你不能更改任何已经发生的事情。你做的任何操作都只是在原来的操作上修改。也就是说，即使你删除了一个分支，修改了一个提交，或者强制重置，你仍然可以回滚这些操作。

但是 reflog 就是用来解决这个问题的。简单的说，它会记录所有 HEAD 的历史，也就是说当你做 reset，checkout 等操作的时候，这些操作会被记录在 reflog 中。

如果你因为 reset 等操作丢失一个提交的时候，你总是可以把它找回来。除非你的操作已经被 git 当做垃圾处理掉了，一般是 30 天以后。

原文：恢复 git reset --hard 的误操作

# 查看 commit 历史

git log

# 修改最近的提交

指定 amend 选项执行提交的话，可以修改同一个分支最近的提交内容和注解

主要使用的场合：

添加最近提交时漏掉的档案
修改最近提交的注解

git commit --amend

# 重设第一个 commit

也就是把所有的改动都重新放回工作区，并清空所有的 commit，这样就可以重新提交第一个 commit 了

git update-ref -d HEAD

# 以新增一个 commit 的方式还原某一个 commit 的修改

git revert <commit-id>

# 回到某个 commit 的状态，并删除后面的 commit

和 revert 的区别：reset 命令会抹去某个 commit id 之后的所有 commit

git reset <commit-id>  #默认就是-mixed参数。

git reset –mixed HEAD^  #回退至上个版本，它将重置HEAD到另外一个commit,并且重置暂存区以便和HEAD相匹配，但是也到此为止。工作区不会被更改。

git reset –soft HEAD~3  #回退至三个版本之前，只回退了commit的信息，暂存区和工作区与回退之前保持一致。如果还要提交，直接commit即可  

git reset –hard <commit-id>  #彻底回退到指定commit-id的状态，暂存区和工作区也会变为指定commit-id版本的内容

1
2
3
4
5
6
7

# 取消过去的提交

# 提取提交

# 查看某段代码是谁写的

blame 的意思为‘责怪’，你懂的。

git blame <file-name>

# 显示本地更新过 HEAD 的 git 命令记录

每次更新了 HEAD 的 git 命令比如 commint、amend、cherry-pick、reset、revert 等都会被记录下来（不限分支），就像 shell 的 history 一样。这样你可以 reset 到任何一次更新了 HEAD 的操作之后，而不仅仅是回到当前分支下的某个 commit 之后的状态。

git reflog

# 修改作者名

git commit --amend --author='Author Name <email@address.com>'

# 把 A 分支的某一个 commit，放到 B 分支上

这个过程需要cherry-pick命令，参考

git checkout <branch-name> && git cherry-pick <commit-id>

# 远程数据库

# 列出所有远程仓库

git remote

# 修改远程仓库的 url

git remote set-url origin <URL>

# 增加远程仓库

通常用于非 clone 的模式，如远程构建好仓库后，本地同时也构建本地的仓库，这时就需要通过下面命令进行关联

git remote add origin <remote-url>

# 从远程仓库根据 ID，拉下某一状态，到本地分支

git fetch origin pull/<id>/head:<branch-name>

# clone 下来指定的单一分支

git clone -b <branch-name> --single-branch https://github.com/user/repo.git

# 查看两个星期内的改动

git whatchanged --since='2 weeks ago'

# 展示所有 tracked 的文件

git ls-files -t

# 展示所有 untracked 的文件

git ls-files --others

# 展示所有忽略的文件

git ls-files --others -i --exclude-standard

# 强制删除 untracked 的文件

可以用来删除新建的文件。如果不指定文件文件名，则清空所有工作的 untracked 文件。clean命令，注意两点：

clean 后，删除的文件无法找回
不会影响 tracked 的文件的改动，只会删除 untracked 的文件

git clean <file-name> -f

# 强制删除 untracked 的目录

可以用来删除新建的目录，注意:这个命令也可以用来删除 untracked 的文件。详情见上一条

git clean <directory-name> -df

# 展示简化的 commit 历史

git log --pretty=oneline --graph --decorate --all

# 把某一个分支到导出成一个文件

git bundle create <file> <branch-name>

# 从包中导入分支

新建一个分支，分支内容就是上面git bundle create命令导出的内容

git clone repo.bundle <repo-dir> -b <branch-name>

# 执行 rebase 之前自动 stash

git rebase --autostash

# 查看 git fetch 之后的文件更改

查看 commit j 记录

git log origin/master ^master

如果你只是想看看如果你使用 git pull，会修改哪些文件，那么就这样做

git diff HEAD @{u} --name-only

如果您想查看当前版本和即将到来的版本之间的所有差异，包括未提交的本地修改，请键入以下内容

git diff @{u} --name-only

# 详细展示一行中的修改

git diff --word-diff

# 清除 gitignore 文件中记录的文件

git clean -X -f

# 展示所有 alias 和 configs

注意： config 分为：当前目录（local）和全局（golbal）的 config，默认为当前目录的 config

git config --local --list (当前目录)
git config --global --list (全局)

1
2

让 git 记录不忽视大小写，避免驼峰命名更改没变化。

git config --global core.ignorecase false

# 展示忽略的文件

git status --ignored

# commit 历史中显示 Branch1 有的，但是 Branch2 没有 commit

git log Branch1 ^Branch2

# 在 commit log 中显示 GPG 签名

git log --show-signature

# 新建并切换到新分支上，同时这个分支没有任何 commit

相当于保存修改，但是重写 commit 历史

git checkout --orphan <branch-name>

# 展示任意分支某一文件的内容

git show <branch-name>:<file-name>

# 忽略某个文件的改动

关闭 track 指定文件的改动，也就是 Git 将不会在记录这个文件的改动

git update-index --assume-unchanged path/to/file

恢复 track 指定文件的改动

git update-index --no-assume-unchanged path/to/file

# 忽略文件的权限变化

不再将文件的权限变化视作改动

git config core.fileMode false

# 在 commit log 中查找相关内容

通过 grep 查找，given-text：所需要查找的字段

git log --all --grep='<given-text>'

# 把暂存区的指定 file 放到工作区中

不添加参数，默认是-mixed

git reset <file-name>

# 强制推送

git push -f <remote-name> <branch-name>

⬆ 返回顶部

# 参考资料

小姐姐用动图展示 10 个 Git 命令
learnGitBranching 一个 git 交互沙箱，可以让你直观看到 git 背后做了什么。
如何同时使用外网码云和内网 Gitlab

← VUE Git 工作流 →

# Git 常用命令集合

# 开卷必读

# 基本操作

# git 设置和取消代理解决 push 和 clone 无法进行的问题

# Github 进行 fork 后如何与原仓库同步

# 回退操作

# 合并操作

# 设置大小写不敏感

# 展示帮助信息

# 创建数据库

# 添加文件或目录到索引

# 提交追加到索引的文件

# GIS 设定

# 显示设定清单

# 删除全局设置

# 输出彩色

# 设定 用户名/电子邮件地址

# 查看全局的用户名和邮箱

# 查看 git 配置

# 给 git 命令起别名

# 把不需要用的文件归类到非管理对象

# https 连接 push 不输入密码

# 手把手教你设置 SSH 连接

# Mac

# window

# ⚠️ 在本地配置多个 SSH-Key

# 回到远程仓库的状态

# 展示工作区和暂存区的不同

# 展示暂存区和最近版本的不同

# 展示暂存区、工作区和最近版本的不同

# 操作分支

# 创建并切换到本地分支

# 创建并切换到远程分支

# 删除本地分支

# 删除远程分支

# 重命名本地分支

# 快速切换分支

# 删除已经合并到 master 的分支

# 展示本地分支关联远程仓库的情况

# 关联远程分支

# 列出所有远程分支

# 合并分支

# merge

# cherry-pick

# rebase

# 合并多个 commit 为一个完整的 commit

# 将某一段 commit 粘贴到另外一个分支上

# 从其他分支合并指定文件或文件夹

# 列出本地和远程分支

# 以最后提交的顺序列出所有 Git 分支

# stash

# 存储当前的修改，但不用提交 commit

# 展示所有 stashes

# 回到某个 stash 的状态

# 保存当前状态，包括 untracked 的文件

# 回到最后一个 stash 的状态，并删除这个 stash

# 删除所有的 stash

# 从 stash 中拿出某个文件的修改

# 操作标签

# 本地创建标签

# 删除本地标签

# 查看标签

# 推送标签到远程仓库

# 删除远程标签

# 切回到某个标签

# 放弃工作区的修改

# 恢复删除的文件

# 改写提交

# 恢复 git reset --hard 的误操作

# 查看 commit 历史

# 修改最近的提交

# 重设第一个 commit

# 以新增一个 commit 的方式还原某一个 commit 的修改

# 回到某个 commit 的状态，并删除后面的 commit

# 取消过去的提交

# 提取提交

# 查看某段代码是谁写的

# 显示本地更新过 HEAD 的 git 命令记录

# 修改作者名

# 把 A 分支的某一个 commit，放到 B 分支上

# 设定用户名/电子邮件地址