Git基本操作流程

技术背景

Gitee是一款国内的git托管服务，对于国内用户较为友好，用户可以访问Gitee地址来创建自己的帐号和项目，并托管在Gitee平台上。既然是git的托管服务，那我们就可以先看看git的一些基本用法：

[dechin@dechin-manjaro ~]$ git --help
用法：git [--version] [--help] [-C <路径>] [-c <名称>=<取值>]
           [--exec-path[=<路径>]] [--html-path] [--man-path] [--info-path]
           [-p | --paginate | -P | --no-pager] [--no-replace-objects] [--bare]
           [--git-dir=<路径>] [--work-tree=<路径>] [--namespace=<名称>]
           <命令> [<参数>]

这些是各种场合常见的 Git 命令：

开始一个工作区（参见：git help tutorial）
   clone             克隆仓库到一个新目录
   init              创建一个空的 Git 仓库或重新初始化一个已存在的仓库

在当前变更上工作（参见：git help everyday）
   add               添加文件内容至索引
   mv                移动或重命名一个文件、目录或符号链接
   restore           恢复工作区文件
   rm                从工作区和索引中删除文件
   sparse-checkout   初始化及修改稀疏检出

检查历史和状态（参见：git help revisions）
   bisect            通过二分查找定位引入 bug 的提交
   diff              显示提交之间、提交和工作区之间等的差异
   grep              输出和模式匹配的行
   log               显示提交日志
   show              显示各种类型的对象
   status            显示工作区状态

扩展、标记和调校您的历史记录
   branch            列出、创建或删除分支
   commit            记录变更到仓库
   merge             合并两个或更多开发历史
   rebase            在另一个分支上重新应用提交
   reset             重置当前 HEAD 到指定状态
   switch            切换分支
   tag               创建、列出、删除或校验一个 GPG 签名的标签对象

协同（参见：git help workflows）
   fetch             从另外一个仓库下载对象和引用
   pull              获取并整合另外的仓库或一个本地分支
   push              更新远程引用和相关的对象

命令 'git help -a' 和 'git help -g' 显示可用的子命令和一些概念帮助。
查看 'git help <命令>' 或 'git help <概念>' 以获取给定子命令或概念的
帮助。
有关系统的概述，查看 'git help git'。

如果git安装成功，就会有上述的执行反馈。我们可以在git命令行上进行操作，比如执行代码的提交等任务。

拷贝仓库

首先我们在Gitee上面创建好一个项目，或者我们可以查看其他已经创建好的项目的首页，一般是如下的形式：



我们可以点击这里的Fork，将该仓库fork到自己的帐号下。一般如果我们没有原仓库的developer权限的话，只能通过提交Pull Request来进行代码提交。因此操作逻辑变成了：先把代码仓Fork到自己的帐号下，在自己的帐号下进行修改，将Fork仓库的代码更新到源仓库代码中。Fork成功后可以在自己的帐号下看到这样的一个项目：

拉取仓库

在通过上一章节的方法拷贝了仓库到自己的帐号下之后，我们可以将该仓库下载到本地进行操作，使用git clone即可：

[dechin@dechin-manjaro 2021-quantum]$ git clone https://gitee.com/dechin/your_library.git
正克隆到 'your_library'...
Username for 'https://gitee.com': dechin
Password for 'https://dechin@gitee.com':
remote: Enumerating objects: 200, done.
remote: Counting objects: 100% (200/200), done.
remote: Compressing objects: 100% (113/113), done.
remote: Total 200 (delta 85), reused 200 (delta 85), pack-reused 0
接收对象中: 100% (200/200), 2.01 MiB | 433.00 KiB/s, 完成.
处理 delta 中: 100% (85/85), 完成.

下载仓库完成后，可以看到本地新建了一个名为your_library的目录，点击进去就是我们下载下来的仓库代码。

这里我们顺带介绍一下在本地用vim操作的一些简单技巧，比如显示行号及其效果图片：

:set nu

取消行号显示及其效果图片：

:set nonu

提交更新

在上一章节中我们介绍了如何将代码下载到本地，下载到本地之后我们可以使用各种的编辑器和IDE进行代码增加修改与测试。譬如完成了某一项任务之后，修改了一个名为_circuit_level_count_test.py的文件，那我们就可以将这个代码文件用git add提交到远程仓库：

[dechin@dechin-manjaro tests]$ git add _circuit_level_count_test.py

为了使得代码库的历史更加明了，我们最好规范一下提交信息，比如下述示例介绍了一个案例，修复了#i3CDFM这个Issue，那么我们就可以将提交信息按照如下写法进行编写：

[dechin@dechin-manjaro tests]$ git commit -m 'Fix issue #i3CDFM'
作者身份未知

*** 请告诉我你是谁。

运行

  git config --global user.email "you@example.com"
  git config --global user.name "Your Name"

来设置您账号的缺省身份标识。
如果仅在本仓库设置身份标识，则省略 --global 参数。
fatal: 无法自动探测邮件地址（得到 'dechin@dechin-manjaro.(none)'）

一开始任务进行的不太顺利，按照提示中的说法，是因为我们没有配置帐号和邮箱，这里我们可以用提示的指令进行配置：

[dechin@dechin-manjaro tests]$ git config --global user.email "your_email@gmail.com"
[dechin@dechin-manjaro tests]$ git config --global user.name "dechin"

配置完基本信息之后，我们再次尝试代码提交信息的编写：

[dechin@dechin-manjaro tests]$ git commit -m 'Fix issue #i3CDFM'[master 591f9cf] Fix issue #i3CDFM
 1 file changed, 2 insertions(+), 5 deletions(-)

在上述信息出现之后，就表示执行成功了，那么我们就可以进行远程代码提交了：

[dechin@dechin-manjaro tests]$ git push
Username for 'https://gitee.com': dechin
Password for 'https://dechin@gitee.com':
枚举对象中: 7, 完成.
对象计数中: 100% (7/7), 完成.
使用 8 个线程进行压缩
压缩对象中: 100% (4/4), 完成.
写入对象中: 100% (4/4), 411 字节 | 411.00 KiB/s, 完成.
总共 4（差异 3），复用 0（差异 0），包复用 0
remote: Powered by GITEE.COM [GNK-5.0]
To https://gitee.com/dechin/your_library.git
   6e345ad..591f9cf  master -> master

提交过程中有可能要求我们输入Gitee平台的用户名和密码，我们按照提示进行输入即可。需要注意的是，如果提交的不是默认分支，最好可以指定一个分支进行提交，比如git push origin master。

多次提交

一般在一次特性提交的过程中，会涉及到不止一次的提交，我们也可以将这些提交同步刷新到同一个分支下，相关的操作都在上一章节中介绍过，这里我们仅简单展示一下这个流程：

[dechin@dechin-manjaro drivers]$ git add _save_molecule.py
[dechin@dechin-manjaro drivers]$ git commit -m 'Fix issue'
[master bff0b02] Fix issue
 1 file changed, 3 insertions(+), 6 deletions(-)
[dechin@dechin-manjaro drivers]$ git push
Username for 'https://gitee.com': dechin
Password for 'https://dechin@gitee.com':
枚举对象中: 11, 完成.
对象计数中: 100% (11/11), 完成.
使用 8 个线程进行压缩
压缩对象中: 100% (5/5), 完成.
写入对象中: 100% (6/6), 526 字节 | 526.00 KiB/s, 完成.
总共 6（差异 4），复用 0（差异 0），包复用 0
remote: Powered by GITEE.COM [GNK-5.0]
To https://gitee.com/dechin/your_library.git
   591f9cf..bff0b02  master -> master

提交成功2次之后，我们可以用如下指令查看历史提交信息，这里的-n 5表示我们只查询最近的5条提交信息：

[dechin@dechin-manjaro your_library]$ git log --oneline --graph -n 5
* bff0b02 (HEAD -> master, origin/master, origin/HEAD) Fix issue
* 591f9cf Fix issue #i3CDFM
* 6e345ad update README.md.
* 591af5d update README.md.
* 664d276 modify the setup.py

这里编号bff0b02和编号591f9cf的commit就是我们刚才所更新的两条，我们还可以在这里看到commit的信息。

变基

在上一章节中，我们可以看到过往的2条commit实际上是在执行同一个任务，比如修复某一个issue。但是这里的commit信息却有2条，因为我们是分了2次来提交的，这显得提交的信息和内容非常的不简洁，变基（rebase）就是优化这个commit信息显示的方案，我们可以将过往的2条相同的提交记录合并成1条：

[dechin@dechin-manjaro your_library]$ git rebase --interactive HEAD~2
成功变基并更新 refs/heads/master。

这里省略了一些编辑的流程，实际上我们要进入到一个rebase的编辑界面，我们pick需要保留的commit。对于不需要保留的commit信息，我们可以直接将前面的pick改成fixup，然后删除后面的commit信息。变基执行完毕之后，需要强行push：

[dechin@dechin-manjaro your_library]$ git push --force
Username for 'https://gitee.com': dechin
Password for 'https://dechin@gitee.com':
枚举对象中: 15, 完成.
对象计数中: 100% (15/15), 完成.
使用 8 个线程进行压缩
压缩对象中: 100% (7/7), 完成.
写入对象中: 100% (8/8), 731 字节 | 731.00 KiB/s, 完成.
总共 8（差异 6），复用 0（差异 0），包复用 0
remote: Powered by GITEE.COM [GNK-5.0]
To https://gitee.com/dechin/your_library.git
 + bff0b02...7ffc12a master -> master (forced update)

远程链接

我们可以使用git remote -v查看当前仓库的远程链接状态，如果要从我们Fork的仓库向原始仓库提交PR的话，就需要创建两者的链接。如果是链接未建立的情况，该命令的返回结果如下：

[dechin@dechin-manjaro your_library]$ git remote -v
origin  https://gitee.com/dechin/your_library.git (fetch)
origin  https://gitee.com/dechin/your_library.git (push)

这里只显示了Fork之后的仓库的地址，说明我们还没有跟原始仓库建立起链接，这时候需要执行upstream指令：

[dechin@dechin-manjaro your_library]$ git remote add upstream https://gitee.com/origin_library.git

此时再运行git remote -v，我们就可以看到新的远程链接：

[dechin@dechin-manjaro your_library]$ git remote -v
origin  https://gitee.com/dechin/your_library.git (fetch)
origin  https://gitee.com/dechin/your_library.git (push)
upstream        https://gitee.com/origin_library.git (fetch)
upstream        https://gitee.com/origin_library.git (push)

提交PR

在上述操作流程都结束后，我们可以准备在Gitee界面上直接提交Pull Request了。首先找到我们Fork过来的仓库：



点击新建Pull Request，选择源分支为我们Fork过来的分支，目标分支选择原始仓库中的目标分支，然后往下拉可以看到我们提交的更新内容，这里我们所有的提交内容被压成了一个commit：



最后提交PR，等待审批人审批即可。

补充示例

前面我们说到修改pick为fixup，但是缺少了一个示例图，这里重新再提交一个新的commit，来展示这个过程。首先我们执行rebase的时候会弹出这样的一个命令行界面：



这里可以直接编辑，因此我们将第二行，也就是我们需要合并的提交，修改为fixup，并且去掉了后面的commit信息：



最后同样的提交上去，我们可以在PR里面看到commit仍然只有一条信息，但是代码修改是有同步的。



这里也需要额外说明一下，在同一条PR未关闭的情况下，所有在源分支上的提交都会被同步到这个PR里面来。

修改编辑器

在上一章节中我们看到了一个很奇怪的编辑器，这是因为git默认的编辑器不是vim，但是我们可以手动将其配置为本地的vim编辑器。执行vim ~/.gitconfig编辑git的配置文件，我们发现在这个文件中已经有我们此前配置过的部分信息:

[user]
        email = your_email@gmail.com
        name = dechin

这里我们增加一个editor的配置即可使用vim来编辑git执行中的指令：

[user]
        email = your_email@gmail.com
        name = dechin
[core]
        editor = /usr/bin/vim

如果坚持要使用原本的编辑器，那么在编辑结束之后，需要执行ctrl+X退出，选择Y选项保存修改，最后回车退出修改状态，同样也是可以的，只是使用vim对于大部分人来说会更加的顺手。

总结概要

在本文中我们通过一个实例来介绍了Git的基本用法，包括提交代码、远程链接以及变基等，这使得我们可以更美观更简洁的去维护我们自己的开源代码仓库。

版权声明

本文首发链接为：https://www.cnblogs.com/dechinphy/p/git.html

作者ID：DechinPhy

更多原著文章请参考：https://www.cnblogs.com/dechinphy/