AlexChen's Blog

Appearance

Git 简介 ​

Git 是一种分布式版本控制系统，它可以不受网络连接的限制，加上其它众多优点，目前已经成为程序开发人员做项目版本管理时的首选，非开发人员也可以用 Git 来做自己的文档版本管理工具。

推荐 Git 学习网站：https://learngitbranching.js.org/?locale=zh_CN

安装 Git ​

  1. 下载 Git 安装包

从 Git 官网 下载 Git 安装包发行版

  1. 双击安装包安装

Git 安装时有许多可选配置，无特殊需求，使用默认选择即可。

Git 常用配置 ​

  1. 配置 Git 全局用户和邮箱

使用如下命令配置：

bash
git config --global user.name "alexchen"
git config --global user.email "alexchen.tech@gmail.com"
git config --global user.name "alexchen"
git config --global user.email "alexchen.tech@gmail.com"

如果你只想改变当前 Git 仓库的配置，去掉 global 参数即可。

bash
git config user.name "alexchen"
git config user.email "alexchen.tech@gmail.com"
git config user.name "alexchen"
git config user.email "alexchen.tech@gmail.com"

查看配置：

bash
git config user.name
git config user.email
git config user.name
git config user.email

如果你需要删除配置，可以使用：

bash
git config --global --unset user.name
git config --global --unset user.name
  1. Git 配置换行符自动转换

autocrlf 配置选项：Git 提供了一个叫做autocrlf的配置选项，用于在不同的操作系统之间自动转换换行符。你可以通过以下命令设置此选项：

bash
git config --global core.autocrlf true
git config --global core.autocrlf true

该命令会设置 Git 核心配置中的autocrlf为true，即自动将换行符转换为适合当前操作系统的格式。这在 Windows 系统上很有用，因为 Windows 使用 CRLF 格式。

Github 配置 ssh 密钥 ​

在 github 上配置了 ssh 密钥后，可以使用 ssh 协议拉取和推送代码，不需要重复的输入 github 帐号和密码。

  1. 本地生成密钥

打开终端，输入生成密钥到命令：

bash
ssh-keygen -t ed25519 -C "your_email@example.com"
ssh-keygen -t ed25519 -C "your_email@example.com"

或者

bash
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

连续点击确定，生成的密钥会存在当前系统用户的 .ssh 文件夹下面，id_rsa 是私钥，id_rsa.pub 是公钥。

  1. 复制公钥内容
bash
pbcopy < ~/.ssh/id_ed25519.pub
pbcopy < ~/.ssh/id_ed25519.pub

或者

bash
pbcopy < ~/.ssh/id_rsa.pub
pbcopy < ~/.ssh/id_rsa.pub

取决于你之前使用的密钥生成算法和之后的重命名。

  1. 将公钥添加到 github

浏览器访问 https://github.com/settings/keys 打开 ssh 配置界面，点击 [new ssh key]，在 key 输入框中粘贴上一步拷贝的公钥内容，并自己命名一个 title，然后保存。

  1. 测试 ssh 访问
bash
ssh -T git@github.com
ssh -T git@github.com

首次使用会提示是否继续连接，输入 yes：

bash
The authenticity of host 'github.com (IP ADDRESS)' can't be established.
ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU.
Are you sure you want to continue connecting (yes/no)?
The authenticity of host 'github.com (IP ADDRESS)' can't be established.
ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU.
Are you sure you want to continue connecting (yes/no)?

然后会看到：

bash
Hi USERNAME! You've successfully authenticated, but GitHub does not provide shell access.
Hi USERNAME! You've successfully authenticated, but GitHub does not provide shell access.

更多操作参考 Github 文档

基础操作 ​

所谓实用主义，就是掌握了以下知识就可以玩转 Git，轻松应对 90% 以上的需求。以下是实用主义型的 Git 命令列表，先大致看一下

  • git clone
  • git config
  • git branch
  • git checkout
  • git status
  • git add
  • git commit
  • git push
  • git pull
  • git log
  • git tag

接下来，将通过对 我的博客 仓库进行实例操作，讲解如何使用 Git 拉取代码到提交代码的整个流程。

git clone ​

从 git 服务器拉取代码

git clone https://github.com/gafish/gafish.github.com.git
git clone https://github.com/gafish/gafish.github.com.git

代码下载完成后在当前文件夹中会有一个 gafish.github.com 的目录，通过 cd gafish.github.com 命令进入目录。

git config ​

配置开发者用户名和邮箱

git config user.name gafish
git config user.email gafish@qqqq.com
git config user.name gafish
git config user.email gafish@qqqq.com

每次代码提交的时候都会生成一条提交记录，其中会包含当前配置的用户名和邮箱。

git branch ​

创建、重命名、查看、删除项目分支，通过 Git 做项目开发时，一般都是在开发分支中进行，开发完成后合并分支到主干。

git branch daily/0.0.0
git branch daily/0.0.0

创建一个名为 daily/0.0.0 的日常开发分支，分支名只要不包括特殊字符即可。

git branch -m daily/0.0.0 daily/0.0.1
git branch -m daily/0.0.0 daily/0.0.1

如果觉得之前的分支名不合适，可以为新建的分支重命名，重命名分支名为 daily/0.0.1

git branch
git branch

通过不带参数的 branch 命令可以查看当前项目分支列表

git branch -d daily/0.0.1
git branch -d daily/0.0.1

如果分支已经完成使命则可以通过 -d 参数将分支删除，这里为了继续下一步操作，暂不执行删除操作

git checkout ​

切换分支

git checkout daily/0.0.1
git checkout daily/0.0.1

切换到 daily/0.0.1 分支，后续的操作将在这个分支上进行

git status ​

查看文件变动状态

通过任何你喜欢的编辑器对项目中的 README.md 文件做一些改动，保存。

git status
git status

通过 git status 命令可以看到文件当前状态 Changes not staged for commit:（改动文件未提交到暂存区）

On branch daily/0.0.1
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)
    modified:   README.md
no changes added to commit (use "git add" and/or "git commit -a")
On branch daily/0.0.1
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)
    modified:   README.md
no changes added to commit (use "git add" and/or "git commit -a")

git add ​

添加文件变动到暂存区

git add README.md
git add README.md

通过指定文件名 README.md 可以将该文件添加到暂存区，如果想添加所有文件可用 git add . 命令，这时候可通过 git status 看到文件当前状态 Changes to be committed: （文件已提交到暂存区）

On branch daily/0.0.1
Changes to be committed:
  (use "git reset HEAD <file>..." to unstage)
    modified:   README.md
On branch daily/0.0.1
Changes to be committed:
  (use "git reset HEAD <file>..." to unstage)
    modified:   README.md

git commit ​

提交文件变动到版本库

git commit -m '这里写提交原因'
git commit -m '这里写提交原因'

通过 -m 参数可直接在命令行里输入提交描述文本

git push ​

将本地的代码改动推送到服务器

git push origin daily/0.0.1
git push origin daily/0.0.1

origin 指代的是当前的 git 服务器地址，这行命令的意思是把 daily/0.0.1 分支推送到服务器，当看到命令行返回如下字符表示推送成功了。

Counting objects: 3, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 267 bytes | 0 bytes/s, done.
Total 3 (delta 1), reused 0 (delta 0)
remote: Resolving deltas: 100% (1/1), completed with 1 local objects.
To https://github.com/gafish/gafish.github.com.git
 * [new branch]      daily/0.0.1 -> daily/0.0.1
Counting objects: 3, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 267 bytes | 0 bytes/s, done.
Total 3 (delta 1), reused 0 (delta 0)
remote: Resolving deltas: 100% (1/1), completed with 1 local objects.
To https://github.com/gafish/gafish.github.com.git
 * [new branch]      daily/0.0.1 -> daily/0.0.1

现在我们回到 Github 网站的项目首页，点击 Branch:master 下拉按钮，就会看到刚才推送的 daily/00.1 分支了

git pull ​

将服务器上的最新代码拉取到本地

git pull origin daily/0.0.1
git pull origin daily/0.0.1

如果其它项目成员对项目做了改动并推送到服务器，我们需要将最新的改动更新到本地，这里我们来模拟一下这种情况。

进入 Github 网站的项目首页，再进入 daily/0.0.1 分支，在线对 README.md 文件做一些修改并保存，然后在命令中执行以上命令，它将把刚才在线修改的部分拉取到本地，用编辑器打开 README.md ，你会发现文件已经跟线上的内容同步了。

如果线上代码做了变动，而你本地的代码也有变动，拉取的代码就有可能会跟你本地的改动冲突，一般情况下 Git 会自动处理这种冲突合并，但如果改动的是同一行，那就需要手动来合并代码，编辑文件，保存最新的改动，再通过 git add .和 git commit -m 'xxx' 来提交合并。

git log ​

查看版本提交记录

git log
git log

通过以上命令，我们可以查看整个项目的版本提交记录，它里面包含了提交人、日期、提交原因等信息，得到的结果如下：

commit c334730f8dba5096c54c8ac04fdc2b31ede7107a
Author: gafish <gafish@qqqq.com>
Date:   Wed Jan 11 09:44:13 2017 +0800
    Update README.md
commit ba6e3d21fcb1c87a718d2a73cdd11261eb672b2a
Author: gafish <gafish@qqqq.com>
Date:   Wed Jan 11 09:31:33 2017 +0800
    test
.....
commit c334730f8dba5096c54c8ac04fdc2b31ede7107a
Author: gafish <gafish@qqqq.com>
Date:   Wed Jan 11 09:44:13 2017 +0800
    Update README.md
commit ba6e3d21fcb1c87a718d2a73cdd11261eb672b2a
Author: gafish <gafish@qqqq.com>
Date:   Wed Jan 11 09:31:33 2017 +0800
    test
.....

提交记录可能会非常多，按 J 键往下翻，按 K 键往上翻，按 Q 键退出查看

git tag ​

为项目标记里程碑

git tag publish/0.0.1
git push origin publish/0.0.1
git tag publish/0.0.1
git push origin publish/0.0.1

当我们完成某个功能需求准备发布上线时，应该将此次完整的项目代码做个标记，并将这个标记好的版本发布到线上，这里我们以 publish/0.0.1 为标记名并发布，当看到命令行返回如下内容则表示发布成功了

Total 0 (delta 0), reused 0 (delta 0)
To https://github.com/gafish/gafish.github.com.git
 * [new tag]         publish/0.0.1 -> publish/0.0.1
Total 0 (delta 0), reused 0 (delta 0)
To https://github.com/gafish/gafish.github.com.git
 * [new tag]         publish/0.0.1 -> publish/0.0.1

.gitignore ​

设置哪些内容不需要推送到服务器，这是一个配置文件

touch .gitignore
touch .gitignore

.gitignore 不是 Git 命令，而在项目中的一个文件，通过设置 .gitignore 的内容告诉 Git 哪些文件应该被忽略不需要推送到服务器，通过以上命令可以创建一个 .gitignore 文件，并在编辑器中打开文件，每一行代表一个要忽略的文件或目录，如：

demo.html
build/
demo.html
build/

以上内容的意思是 Git 将忽略 demo.html 文件 和 build/ 目录，这些内容不会被推送到服务器上

小结 ​

通过掌握以上这些基本命令就可以在项目中开始用起来了，如果追求实用，那关于 Git 的学习就可以到此结束了，偶尔遇到的问题也基本上通过 Google 也能找到答案，如果想深入探索 Git 的高阶功能，那就继续往下看 进阶篇 部分。

进阶篇 ​

基本概念 ​

工作区（Working Directory） ​

就是你在电脑里能看到的目录，比如上文中的 gafish.github.com 文件夹就是一个工作区

git_working_directory

本地版本库（Local Repository） ​

工作区有一个隐藏目录 .git，这个不算工作区，而是 Git 的版本库。

git_local_repository

暂存区（stage） ​

本地版本库里存了很多东西，其中最重要的就是称为 stage（或者叫 index）的暂存区，还有 Git 为我们自动创建的第一个分支 master，以及指向 master 的一个指针叫 HEAD。

远程版本库（Remote Repository） ​

一般指的是 Git 服务器上所对应的仓库，本文的示例所在的github仓库就是一个远程版本库

git_remote_repository

以上概念之间的关系 ​

工作区、暂存区、本地版本库、远程版本库之间几个常用的 Git 操作流程如下图所示：

git_flow.jpg

分支（Branch） ​

分支是为了将修改记录的整个流程分开存储，让分开的分支不受其它分支的影响，所以在同一个数据库里可以同时进行多个不同的修改

git_branch

主分支（Master） ​

前面提到过 master 是 Git 为我们自动创建的第一个分支，也叫主分支，其它分支开发完成后都要合并到 master

git_master

标签（Tag） ​

标签是用于标记特定的点或提交的历史，通常会用来标记发布版本的名称或版本号（如：publish/0.0.1），虽然标签看起来有点像分支，但打上标签的提交是固定的，不能随意的改动，参见上图中的1.0 / 2.0 / 3.0

HEAD 指向的就是当前分支的最新提交

git_head

以上概念了解的差不多，那就可以继续往下看，下面将以具体的操作类型来讲解 Git 的高阶用法

操作文件 ​

git add ​

添加文件到暂存区

git add -i
git add -i

通过此命令将打开交互式子命令系统，你将看到如下子命令

***Commands***
  1: status      2: update      3: revert      4: add untracked
  5: patch      6: diff      7: quit      8: help
***Commands***
  1: status      2: update      3: revert      4: add untracked
  5: patch      6: diff      7: quit      8: help

通过输入序列号或首字母可以选择相应的功能，具体的功能解释如下：

  • status：功能上和 git add -i 相似，没什么鸟用
  • update：详见下方 git add -u
  • revert：把已经添加到暂存区的文件从暂存区剔除，其操作方式和 update类似
  • add untracked：可以把新增的文件添加到暂存区，其操作方式和 update 类似
  • patch：详见下方 git add -p
  • diff：比较暂存区文件和本地版本库的差异，其操作方式和 update 类似
  • quit：退出 git add -i 命令系统
  • help：查看帮助信息
git add -p
git add -p

直接进入交互命令中最有用的 patch 模式

这是交互命令中最有用的模式，其操作方式和 update 类似，选择后 Git 会显示这些文件的当前内容与本地版本库中的差异，然后您可以自己决定是否添加这些修改到暂存区，在命令行 Stage deletion [y,n,q,a,d,/,?]? 后输入 y,n,q,a,d,/,? 其中一项选择操作方式，具体功能解释如下：

  • y：接受修改
  • n：忽略修改
  • q：退出当前命令
  • a：添加修改
  • d：放弃修改
  • /：通过正则表达式匹配修改内容
  • ?：查看帮助信息
git add -u
git add -u

直接进入交互命令中的 update 模式

它会先列出工作区 修改 或 删除 的文件列表，新增 的文件不会被显示，在命令行 Update>> 后输入相应的列表序列号表示选中该项，回车继续选择，如果已选好，直接回车回到命令主界面

git add --ignore-removal .
git add --ignore-removal .

添加工作区 修改 或 新增 的文件列表， 删除 的文件不会被添加

git commit ​

把暂存区的文件提交到本地版本库

git commit -m '第一行提交原因'  -m '第二行提交原因'
git commit -m '第一行提交原因'  -m '第二行提交原因'

不打开编辑器，直接在命令行中输入多行提交原因

git commit -am '提交原因'
git commit -am '提交原因'

将工作区 修改 或 删除 的文件提交到本地版本库， 新增 的文件不会被提交

git commit --amend -m '提交原因'
git commit --amend -m '提交原因'

修改最新一条提交记录的提交原因

git commit -C HEAD
git commit -C HEAD

将当前文件改动提交到 HEAD 或当前分支的历史 ID

git mv ​

移动或重命名文件、目录

git mv a.md b.md -f
git mv a.md b.md -f

将 a.md 重命名为 b.md ，同时添加变动到暂存区，加 -f 参数可以强制重命名，相比用 mv a.md b.md 命令省去了 git add 操作

git rm ​

从工作区和暂存区移除文件

git rm b.md
git rm b.md

从工作区和暂存区移除文件 b.md ，同时添加变动到暂存区，相比用 rm b.md 命令省去了 git add 操作

git rm src/ -r
git rm src/ -r

允许从工作区和暂存区移除目录

git status ​

git status -s
git status -s

以简短方式查看工作区和暂存区文件状态，示例如下：

M demo.html
?? test.html
git status --ignored
M demo.html
?? test.html
git status --ignored

查看工作区和暂存区文件状态，包括被忽略的文件

操作分支 ​

git branch ​

查看、创建、删除分支

git branch -a
git branch -a

查看本地版本库和远程版本库上的分支列表

git branch -r
git branch -r

查看远程版本库上的分支列表，加上 -d 参数可以删除远程版本库上的分支

git branch -D
git branch -D

分支未提交到本地版本库前强制删除分支

git branch -vv
git branch -vv

查看带有最后提交 id、最近提交原因等信息的本地版本库分支列表

git merge ​

将其它分支合并到当前分支

git merge --squash
git merge --squash

将待合并分支上的 commit 合并成一个新的 commit 放入当前分支，适用于待合并分支的提交记录不需要保留的情况

git merge --no-ff
git merge --no-ff

默认情况下，Git 执行"快进式合并"（fast-farward merge），会直接将 Master分支指向 Develop 分支，使用 --no-ff 参数后，会执行正常合并，在 Master分支上生成一个新节点，保证版本演进更清晰。

git merge --no-edit
git merge --no-edit

在没有冲突的情况下合并，不想手动编辑提交原因，而是用 Git 自动生成的类似 Merge branch 'test' 的文字直接提交

git checkout ​

切换分支

git checkout -b daily/0.0.1
git checkout -b daily/0.0.1

创建 daily/0.0.1 分支，同时切换到这个新创建的分支

git checkout HEAD demo.html
git checkout HEAD demo.html

从本地版本库的 HEAD（也可以是提交 ID、分支名、Tag 名）历史中检出 demo.html 覆盖当前工作区的文件，如果省略 HEAD 则是从暂存区检出

git checkout --orphan new_branch
git checkout --orphan new_branch

这个命令会创建一个全新的，完全没有历史记录的新分支，但当前源分支上所有的最新文件都还在，真是强迫症患者的福音，但这个新分支必须做一次 git commit操作后才会真正成为一个新分支。

git checkout -p other_branch
git checkout -p other_branch

这个命令主要用来比较两个分支间的差异内容，并提供交互式的界面来选择进一步的操作，这个命令不仅可以比较两个分支间的差异，还可以比较单个文件的差异。

git stash ​

在 Git 的栈中保存当前修改或删除的工作进度，当你在一个分支里做某项功能开发时，接到通知把昨天已经测试完没问题的代码发布到线上，但这时你已经在这个分支里加入了其它未提交的代码，这个时候就可以把这些未提交的代码存到栈里。

git stash
git stash

将未提交的文件保存到 Git 栈中

git stash list
git stash list

查看栈中保存的列表

git stash show stash@{0}
git stash show stash@{0}

显示栈中其中一条记录

git stash drop stash@{0}
git stash drop stash@{0}

移除栈中其中一条记录

git stash pop
git stash pop

从 Git 栈中检出最新保存的一条记录，并将它从栈中移除

git stash apply stash@{0}
git stash apply stash@{0}

从 Git 栈中检出其中一条记录，但不从栈中移除

git stash branch new_banch
git stash branch new_banch

把当前栈中最近一次记录检出并创建一个新分支

git stash clear
git stash clear

清空栈里的所有记录

git stash create
git stash create

为当前修改或删除的文件创建一个自定义的栈并返回一个 ID，此时并未真正存储到栈里

git stash store xxxxxx
git stash store xxxxxx

将 create 方法里返回的 ID 放到 store 后面，此时在栈里真正创建了一个记录，但当前修改或删除的文件并未从工作区移除

$ git stash create
09eb9a97ad632d0825be1ece361936d1d0bdb5c7
$ git stash store 09eb9a97ad632d0825be1ece361936d1d0bdb5c7
$ git stash list
stash@{0}: Created via "git stash store".
$ git stash create
09eb9a97ad632d0825be1ece361936d1d0bdb5c7
$ git stash store 09eb9a97ad632d0825be1ece361936d1d0bdb5c7
$ git stash list
stash@{0}: Created via "git stash store".

操作历史 ​

git log ​

显示提交历史记录

git log -p
git log -p

显示带提交差异对比的历史记录

git log demo.html
git log demo.html

显示 demo.html 文件的历史记录

git log --since="2 weeks ago"
git log --since="2 weeks ago"

显示 2 周前开始到现在的历史记录，其它时间可以类推

git log --before="2 weeks ago"
git log --before="2 weeks ago"

显示截止到 2 周前的历史记录，其它时间可以类推

git log -10
git log -10

显示最近 10 条历史记录

git log f5f630a..HEAD
git log f5f630a..HEAD

显示从提交 ID f5f630a 到 HEAD 之间的记录，HEAD 可以为空或其它提交 ID

git log --pretty=oneline
git log --pretty=oneline

在一行中输出简短的历史记录

git log --pretty=format:"%h"
git log --pretty=format:"%h"

格式化输出历史记录

Git 用各种 placeholder 来决定各种显示内容，我挑几个常用的显示如下：

  • %H: commit hash
  • %h: 缩短的 commit hash
  • %T: tree hash
  • %t: 缩短的 tree hash
  • %P: parent hashes
  • %p: 缩短的 parent hashes
  • %an: 作者名字
  • %aN: mailmap 的作者名
  • %ae: 作者邮箱
  • %ad: 日期 (--date= 制定的格式)
  • %ar: 日期，相对格式 (1 day ago)
  • %cn: 提交者名字
  • %ce: 提交者 email
  • %cd: 提交日期 (--date= 制定的格式)
  • %cr: 提交日期，相对格式 (1 day ago)
  • %d: ref 名称
  • %s: commit 信息标题
  • %b: commit 信息内容
  • %n: 换行

git cherry-pick ​

合并分支的一条或几条提交记录到当前分支末梢

git cherry-pick 170a305
git cherry-pick 170a305

合并提交 ID 170a305 到当前分支末梢

git reset ​

将当前的分支重设（reset）到指定的 <commit> 或者 HEAD

git reset --mixed <commit>
git reset --mixed <commit>

--mixed 是不带参数时的默认参数，它退回到某个版本，保留文件内容，回退提交历史

git reset --soft <commit>
git reset --soft <commit>

暂存区和工作区中的内容不作任何改变，仅仅把 HEAD 指向 <commit>

git reset --hard <commit>
git reset --hard <commit>

自从 <commit> 以来在工作区中的任何改变都被丢弃，并把 HEAD 指向 <commit>

git rebase ​

重新定义分支的版本库状态

git rebase branch_name
git rebase branch_name

合并分支，这跟 merge 很像，但还是有本质区别，看下图：

git-2024-11-18-09-30-34

合并过程中可能需要先解决冲突，然后执行 git rebase --continue

git rebase -i HEAD~~
git rebase -i HEAD~~

打开文本编辑器，将看到从 HEAD 到 HEAD~~ 的提交如下

pick 9a54fd4 添加commit的说明
pick 0d4a808 添加pull的说明
# Rebase 326fc9f..0d4a808 onto d286baa
#
# Commands:
#  p, pick = use commit
#  r, reword = use commit, but edit the commit message
#  e, edit = use commit, but stop for amending
#  s, squash = use commit, but meld into previous commit
#  f, fixup = like "squash", but discard this commit's log message
#  x, exec = run command (the rest of the line) using shell
#
pick 9a54fd4 添加commit的说明
pick 0d4a808 添加pull的说明
# Rebase 326fc9f..0d4a808 onto d286baa
#
# Commands:
#  p, pick = use commit
#  r, reword = use commit, but edit the commit message
#  e, edit = use commit, but stop for amending
#  s, squash = use commit, but meld into previous commit
#  f, fixup = like "squash", but discard this commit's log message
#  x, exec = run command (the rest of the line) using shell
#

将第一行的 pick 改成 Commands 中所列出来的命令，然后保存并退出，所对应的修改将会生效。如果移动提交记录的顺序，将改变历史记录中的排序。

git revert ​

撤销某次操作，此次操作之前和之后的 commit 和 history 都会保留，并且把这次撤销作为一次最新的提交

git revert HEAD
git revert HEAD

撤销前一次提交操作

git revert HEAD --no-edit
git revert HEAD --no-edit

撤销前一次提交操作，并以默认的 Revert "xxx" 为提交原因

git revert -n HEAD
git revert -n HEAD

需要撤销多次操作的时候加 -n 参数，这样不会每次撤销操作都提交，而是等所有撤销都完成后一起提交

git diff ​

查看工作区、暂存区、本地版本库之间的文件差异，用一张图来解释

git-2024-11-18-09-31-40

git diff --stat
git diff --stat

通过 --stat 参数可以查看变更统计数据

test.md | 1 -
 1 file changed, 1 deletion(-)
test.md | 1 -
 1 file changed, 1 deletion(-)

git reflog ​

reflog 可以查看所有分支的所有操作记录（包括 commit 和 reset 的操作、已经被删除的 commit 记录，跟 git log 的区别在于它不能查看已经删除了的 commit 记录 git-2024-11-18-09-31-59

远程版本库连接 ​

如果在 GitHub 项目初始化之前，文件已经存在于本地目录中，那可以在本地初始化本地版本库，再将本地版本库跟远程版本库连接起来

git init ​

在本地目录内部会生成.git 文件夹

git remote ​

git remote -v
git remote -v

不带参数，列出已经存在的远程分支，加上 -v 列出详细信息，在每一个名字后面列出其远程 url

git remote add origin https://github.com/gafish/gafish.github.com.git
git remote add origin https://github.com/gafish/gafish.github.com.git

添加一个新的远程仓库，指定一个名字，以便引用后面带的 URL

git fetch ​

将远程版本库的更新取回到本地版本库

git fetch origin daily/0.0.1
git fetch origin daily/0.0.1

默认情况下，git fetch 取回所有分支的更新。如果只想取回特定分支的更新，可以指定分支名。

问题排查 ​

git blame ​

查看文件每行代码块的历史信息

git blame -L 1,10 demo.html
git blame -L 1,10 demo.html

截取 demo.html 文件 1-10 行历史信息

git bisect ​

二分查找历史记录，排查 BUG

git bisect start
git bisect start

开始二分查找

git bisect bad
git bisect bad

标记当前二分提交 ID 为有问题的点

git bisect good
git bisect good

标记当前二分提交 ID 为没问题的点

git bisect reset
git bisect reset

查到有问题的提交 ID 后回到原分支

更多操作 ​

git submodule ​

通过 Git 子模块可以跟踪外部版本库，它允许在某一版本库中再存储另一版本库，并且能够保持 2 个版本库完全独立

git submodule add https://github.com/gafish/demo.git demo
git submodule add https://github.com/gafish/demo.git demo

将 demo 仓库添加为子模块

git submodule update demo
git submodule update demo

更新子模块 demo

git gc ​

运行 Git 的垃圾回收功能，清理冗余的历史快照

git archive ​

将加了 tag 的某个版本打包提取

git archive -v --format=zip v0.1 > v0.1.zip
git archive -v --format=zip v0.1 > v0.1.zip

--format 表示打包的格式，如 zip，-v 表示对应的 tag 名，后面跟的是 tag 名，如 v0.1。

-- End --

Git 提交规范 ​

Git 每次提交代码时，都需要写 Commit Message (提交说明)，否则就不允许提交。

bash
git commit -m '第一次提交'
git commit -m '第一次提交'

在工作中一份清晰简介规范的 Commit Message 能让后续代码审查、信息查找、版本回退都更加高效可靠。

Commit Message 标准格式 ​

Commit Message 标准格式包括三个部分：Header，Body，Footer

bash
<type>(<scope>): <subject>
// 空一行
<body>
// 空一行
<footer>
:::
<type>(<scope>): <subject>
// 空一行
<body>
// 空一行
<footer>
:::

其中，Header 是必需的，Body 和 Footer 可以省略。

  • 页眉（header）通常只有一行，包括了提交类型（type）、作用域（scope）和主题（subject）。其中，type 和 subject 是必须的，scope 是可选的。

type

提交类型（type）用于说明此次提交的类型，需要指定为下面其中一个：

Git Commit Type

Scope

作用域（scope）表示此次提交影响的范围。比如可以取值 api，表明只影响了接口。

Subject

主题（subject）描述是简短的一句话，简单说明此次提交的内容。

  • 正文（body）和页眉（footer）这两部分不是必须的。

如果是破坏性的变更，那就必须在提交的正文或脚注加以展示。一个破坏性变更必须包含大写的文本 BREAKING CHANGE，紧跟冒号和空格。脚注必须只包含 BREAKING CHANGE、外部链接、issue 引用和其它元数据信息。例如修改了提交的流程，依赖了一些包，可以在正文写上：BREANKING CHANGE：需要重新 npm install，使用 npm run cm 代替 git commit。

  • 下面给出了一个 Commit Message 例子，该例子中包含了 header 和 body。
bash
chore: 引入commitizen

BREANKING CHANGE：需要重新npm install，使用npm run cm代替git commit
chore: 引入commitizen

BREANKING CHANGE：需要重新npm install，使用npm run cm代替git commit

当然，在平时的提交中，我们也可以只包含 header，比如我们修改了登录页面的某个功能，那么可以这样写 Commit Message。

bash
feat(登录）：添加登录接口
feat(登录）：添加登录接口

Git Commitizen ​

Commitizen 是一个撰写符合上面 Commit Message 标准的一款工具，可以帮助开发者提交符合规范的 Commit Message。

Git 地址：ClickHere

  1. 使用 npm 全局安装
bash
npm install -g commitizen
npm install -g commitizen
  1. 安装适配器
bash
npm install -g cz-conventional-changelog
npm install -g cz-conventional-changelog
  1. 创建适配器配置文件
bash
echo '{ "path": "cz-conventional-changelog" }' > ~/.czrc
echo '{ "path": "cz-conventional-changelog" }' > ~/.czrc

WARNING

如果提示文件格式不是 UTF8，可以使用 ide 打开修改格式后重新保存

  1. 使用示例

使用 git cz 命令代替 git commit 命令，会挨个提示你需要的 Commit message 信息

bash
PS D:\Projects\Github\image-hosting\blog> git cz
cz-cli@4.3.0, cz-conventional-changelog@3.3.0

? Select the type of change that you're committing: feat:     A new feature
? What is the scope of this change (e.g. component or file name): (press enter to skip)
? Write a short, imperative tense description of the change (max 94 chars):
 (51) add file: java/juc_threadpoolexecutor_principle.png
? Provide a longer description of the change: (press enter to skip)

? Are there any breaking changes? No
? Does this change affect any open issues? No
[master 1d8ed0c] feat: add file: java/juc_threadpoolexecutor_principle.png
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 blog/java/juc_threadpoolexecutor_principle.png
PS D:\Projects\Github\image-hosting\blog> git cz
cz-cli@4.3.0, cz-conventional-changelog@3.3.0

? Select the type of change that you're committing: feat:     A new feature
? What is the scope of this change (e.g. component or file name): (press enter to skip)
? Write a short, imperative tense description of the change (max 94 chars):
 (51) add file: java/juc_threadpoolexecutor_principle.png
? Provide a longer description of the change: (press enter to skip)

? Are there any breaking changes? No
? Does this change affect any open issues? No
[master 1d8ed0c] feat: add file: java/juc_threadpoolexecutor_principle.png
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 blog/java/juc_threadpoolexecutor_principle.png

扩展

另一款 Commitizen 适配器： cz-git

Git 常见问题解决方案 ​

  1. 因为使用 vpn 导致的 git 无法 pull 和 push 代码，可以尝试清除 git 的网络代理，命令如下：
bash
git config --global --unset http.proxy
git config --global --unset https.proxy
git config --global --unset http.proxy
git config --global --unset https.proxy

查看网络代理的命令：

bash
git config --global http.proxy
git config --global https.proxy
git config --global http.proxy
git config --global https.proxy

参考资料 ​