廖雪峰 git 教程笔记

| Stephen Tseng | tutorial

文档逻辑厘清

参考教程：廖雪峰的 Git 教程

主要记录关键场景和相关命令。

git 使用关键场景

1、场景回退

回退到上一个版本 git reset --hard HEAD^
回退到特定版本 git reset --hard <HASH>

2、历史命令

查看所有历史命令 git reflog

3、比较不同

工作区跟特定分支的差异比较 git diff HEAD -- <FILE>

4、撤销修改

撤销工作区某个文件的修改 git checkout -- <FILE>
撤销暂存区某个文件的修改 git reset HEAD <FILE>

5、远程版本库

将特定分支推送到远程库并进行关联 git push -u origin <BRANCH>
关联远程库 git remote add origin git@server-name:path/repo-name.git
查看关联的远程版本库 git remote -v
创建远程 origin 的特定分支到本地 git checkout -b <BRANCH> origin/<BRANCH>
指定本地分支与远程分支的链接 git branch --set-upstream-to=origin/<BRANCH> <BRANCH>

修改远程仓库的三种方法

# 修改命令
git remote set-url origin [url]

# 先删后加
git remote rm origin
git remote add origin [url]

# 直接修改 .git/config 文件

6、分支操作

创建并切换到一个新的分支 git checkout -b <BRANCH>
合并特定分支到当前分支 git merge <BRANCH>
删除分支 git branch -d <BRANCH>
以普通模式将特定分支合并到当前分支 git merge --no-ff -m "merge with no-ff" <BRANCH>

7、当前工作区

储藏当前工作区 git stash
查看储藏的工作区 git stash list
（当之前的分支下）恢复到上一个储藏的工作区 git stash apply
（当之前的分支下）恢复到特定的储藏的工作区 git stash apply <NUM>
（当之前的分支下）恢复到上一个储藏的工作区并删除对应的储藏工作区 git stash pop
丢弃某个储藏的工作区 git stash drop <NUM>
丢弃所有储藏的工作区 git stash clear

8、整理提交历史

基础操作，由多线变单条直线 git rebase

9、标签管理

给当前分支打上某个tag git tag <TAG_NAME>
查看所有 tag git tag
给一个特定分支打赏标签 git tag <TAG_NAME> <COMMIT_ID>
查看某个 tag 信息 git show <TAG_NAME>
打标签时指定标签名和描述信息 git tag -a <TAG_NAME> -m "<MESSAGE>"
删除本地标签 git tag -d <TAG_NAME>
删除远程版本库标签 git push origin :refs/tags/<TAG_NAME>
推送全部本地未推送的标签 git push origin --tags

额外补充

  1. git 是一个分布式版本控制系统
  2. 暂存区是 git 的核心概念之一
  3. git 的工作场景：工作区 - 暂存区 - 本地版本库 - 远程版本库
  4. 如果某些文件对你很重要，而且你需要经常关注这些文件的变动情况（比如源代码），那么请保持把工作区的修改提交到暂存区或者版本库的良好习惯
  5. Fast-forward指快进模式，只移动当前指针，速度非常快
  6. 当Git无法自动合并分支时，就必须首先解决冲突。解决冲突后，再提交，合并完成。解决冲突就是把Git合并失败的文件手动编辑为我们希望的内容，再提交
  7. 通常，合并分支时，如果可能，Git会用Fast forward模式，但这种模式下，删除分支后，会丢掉分支信息
  8. 某个分支还没有被合并，如果删除，将丢失掉修改，如果要强行删除，需要使用大写的-D参数
  9. tag 也是版本库的快照，跟分支类似，实际是一个指向某个 commit 的指针，不过 tag 不能移动，分支可以。

其他笔记

1、多人协作的工作模式

因此，多人协作的工作模式通常是这样：

  1. 首先，可以试图用 git push origin <branch-name> 推送自己的修改；
  2. 如果推送失败，则因为远程分支比你的本地更新，需要先用git pull试图合并；
  3. 如果合并有冲突，则解决冲突，并在本地提交；
  4. 没有冲突或者解决掉冲突后，再用 git push origin <branch-name> 推送就能成功！
    如果git pull提示no tracking information，则说明本地分支和远程分支的链接关系没有创建，用命令 git branch --set-upstream-to <branch-name> origin/<branch-name>

2、生成密钥对、修改 ~/.ssh/config 并添加到远程仓库

如果你的电脑需要关联多个远程代码库（如 Github 或 Gitlab），或者多个远程代码库账号（如 Github 的多个账号），那么你需要对你的本机 ssh 密钥对进行管理，因为，两个不同的远程库账号无法关联同一个 ssh 密钥对。

通用的管理思想是：为每一个不同的代码库地址或代码库账号设置一个 ssh 密钥对。

实现方式是通过配置 ~/.ssh/config 文件实现。那么让我们看看具体的场景。

假设现在你有一个 Github 账号和一个 Gitlab 账号，首先你需要分别为每个账号生成一个本机的 ssh 密钥对。

# 生成密钥对的命令
# 注意，如果运行这行命令报错，请自行检索查找是否系统缺少相关依赖
ssh-keygen -t rsa -b 4096 -C "your_email_address@mail.com"
# 运行后，首先需要选择安装路径和名称，一般默认是 ~/.ssh/id_rsa，这里需要特别注意
# 因为你需要区分不同的账号对应的密钥，显然都用默认的 id_rsa 名称是不行的
# 你可以设置为 id_github_rsa 和 id_gitlab_rsa
# 设置好保存路径和密钥对名称后，需要进一步输入该密钥对的加密密码，一般来说这一步可以省略，直接空格键输入

# 生成后，查看刚刚设置的路径，即 ~/.ssh，检查是否生成成功

上面是关于生成两个账号密钥对的一点简单说明，接下来你需要配置 ~/.ssh/config 以使密钥对的区分生效

# 打开 ~/.ssh/config 配置文件
vi ~/.ssh/config

config 的配置方法

# Github
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_github_rsa
# Gitlab
Host gitlab.com
HostName gitlab.com
User git
IdentityFile ~/.ssh/id_gitlab_rsa

3、常用的 Git 别名

[alias]
        co = checkout
        ci = commit -m
        br = branch
        mg = merge
        st = status
        lg = log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit
        last = log -1
        unstage = reset HEAD

配置后，通过 git lg 可查看该 git 仓库的所有提交历史，git last 可以查看最后的提交记录，以此类推。

Git 奇技淫巧

Git 的奇技淫巧🙈

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

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

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

开卷必读

如果之前未使用过 Git，可以学习 Git 小白教程入门

  1. 一定要先测试命令的效果后，再用于工作环境中，以防造成不能弥补的后果！到时候别拿着砍刀来找我
  2. 所有的命令都在git version 2.7.4 (Apple Git-66)下测试通过
  3. 统一概念：
    • 工作区：改动（增删文件和内容）
    • 暂存区：输入命令：git add 改动的文件名，此次改动就放到了 ‘暂存区’
    • 本地仓库(简称：本地)：输入命令：git commit 此次修改的描述，此次改动就放到了 ’本地仓库’，每个 commit，我叫它为一个 ‘版本’。
    • 远程仓库(简称：远程)：输入命令：git push 远程仓库，此次改动就放到了 ‘远程仓库’（GitHub 等)
    • commit-id：输出命令：git log，最上面那行 commit xxxxxx，后面的字符串就是 commit-id
  4. 如果喜欢这个项目，欢迎 Star、提交 Pr、反馈问题😊

目录

展示帮助信息

git help -g

The command output as below:

The common Git guides are:
   attributes          Defining attributes per path
   cli                 Git command-line interface and conventions
   core-tutorial       A Git core tutorial for developers
   cvs-migration       Git for CVS users
   diffcore            Tweaking diff output
   everyday            A useful minimum set of commands for Everyday Git
   glossary            A Git Glossary
   hooks               Hooks used by Git
   ignore              Specifies intentionally untracked files to ignore
   modules             Defining submodule properties
   namespaces          Git namespaces
   repository-layout    Git Repository Layout
   revisions           Specifying revisions and ranges for Git
   tutorial            A tutorial introduction to Git
   tutorial-2          A tutorial introduction to Git: part two
   workflows           An overview of recommended workflows with Git

'git help -a' and 'git help -g' list available subcommands and some concept guides. See 'git help <command>' or 'git help <concept>' to read about a specific subcommand or concept.

回到远程仓库的状态

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

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

重设第一个 commit

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

git update-ref -d HEAD

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

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

git diff

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

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

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

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

git diff --cached

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

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

git diff HEAD

快速切换分支上一个分支

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

列出本地和远程分支

-a 参数相当于：all

git branch -a

创建并切换到本地分支

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 tag

展示当前分支的最近的 tag

git describe --tags --abbrev=0

查看标签详细信息

git tag -ln

本地创建标签

git tag <version-number>

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

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

推送标签到远程仓库

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

git push origin <local-version-number>

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

git push origin --tags

删除本地标签

git tag -d <tag-name>

删除远程标签

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

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 之前的状态

以新增一个 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版本的内容

修改上一个 commit 的描述

git commit --amend

查看 commit 历史

git log

查看某段代码是谁写的

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>'

修改远程仓库的 url

git remote set-url origin <URL>

增加远程仓库

git remote add origin <remote-url>

列出所有远程仓库

git remote

查看两个星期内的改动

git whatchanged --since='2 weeks ago'

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

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

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

给 git 命令起别名

简化命令

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

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

git config --global alias.st status

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

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

git stash

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

untracked 文件：新建的文件

git stash -u

展示所有 stashes

git stash list

回到某个 stash 的状态

git stash apply <stash@{n}>

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

git stash pop

删除所有的 stash

git stash clear

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

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

展示所有 tracked 的文件

git ls-files -t

展示所有 untracked 的文件

git ls-files --others

展示所有忽略的文件

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

强制删除 untracked 的文件

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

  1. clean 后，删除的文件无法找回
  2. 不会影响 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

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

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

详细展示一行中的修改

git diff --word-diff

清除 gitignore 文件中记录的文件

git clean -X -f

展示所有 alias 和 configs

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

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

展示忽略的文件

git status --ignored

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

git log Branch1 ^Branch2

在 commit log 中显示 GPG 签名

git log --show-signature

删除全局设置

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

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

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

git checkout --orphan <branch-name>

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

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

clone 下来指定的单一分支

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

忽略某个文件的改动

关闭 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

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

最新的放在最上面

git for-each-ref --sort=-committerdate --format='%(refname:short)' refs/heads/

在 commit log 中查找相关内容

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

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

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

不添加参数，默认是 -mixed

git reset <file-name>

强制推送

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

一图详解

点击查看大图

《 》