Git基本操作流程


技术背景

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46[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即可:

1
2
3
4
5
6
7
8
9
10[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,那么我们就可以将提交信息按照如下写法进行编写:

1
2
3
4
5
6
7
8
9
10
11
12
13[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)')

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

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

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

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

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

1
2
3
4
5
6
7
8
9
10
11
12[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

回到顶部

多次提交

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16[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条提交信息:

1
2
3
4
5
6[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条:

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

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

1
2
3
4
5
6
7
8
9
10
11
12[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的话,就需要创建两者的链接。如果是链接未建立的情况,该命令的返回结果如下:

1
2
3[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,我们就可以看到新的远程链接:

1
2
3
4
5[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,等待审批人审批即可。

回到顶部

补充示例

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

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

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

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

回到顶部

修改编辑器

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

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

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

1
2
3
4
5[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

(0)

相关推荐

  • 开源中国创始人红薯:从 Git@OSC 到 Gitee,我们在持续变化

    2014 年 1 月 23 日,开源中国社区(OSChina.net)创始人红薯在开源中国社区上发布了一篇<开源中国 2013 大记事>,写大事记似乎是红薯的一个习惯--当有重大事件时,他 ...

  • 尝试中国区的GitHub

    我在GitHub有很多代码仓库,战绩还不错,帮助了十万生信工程师,地址是:https://github.com/jmzeng1314 不过,我比较懒,写代码仅仅是顺手而为,其实对代码本身并不感兴趣,编 ...

  • Github简介

    表白:黑白圣堂血天使,天剑鬼刀阿修罗.  讲解对象:/Github简介 作者:融水公子 rsgz Git$github教程 Git$github教程 http://www.rsgz.top/post/ ...

  • EEDrone开源四旋翼从零开始(5)--git基础

    注册和环境搭建 先注册github.com的账号,官方网站: https://github.com/ 需要一个邮箱,同时也要一个昵称,我的是flyloong,之后会用到. 下载git,地址:https ...

  • 【教程】git代码仓库迁移的详细步骤

    嗨喽!各位小伙伴们,由于公众号做了乱序推送改版,为了保证公众号的推送,能够第一时间及时送达到大家手上,大家记得将我的公众号 加星标置顶 ,公众号每天会送上IT圈独有的资源 ! 今天给大家分享一个Git ...

  • 同样的GitHub包你就下载失败

    对R语言熟练的小伙伴,通常是不仅仅使用CRAN或者bioconductor的包,也会尝试很多开发者未正式发表的包,比如存放在GitHub等仓库的.正常情况下,很容易下载和安装,我让学徒使用她的Wind ...

  • GitHub仓库快速导入Gitee及同步更新

    一.仓库导入 登陆 Gitee 账号,点击右上角的 + 号,点击「从 GitHub 导入仓库」,在跳转的页面中授权 Gitee 访问. 与 GitHub 对接. 选择性的导入您的 Github 项目到 ...

  • goannie 下载器

    表白:黑白圣堂血天使,天剑鬼刀阿修罗.  讲解对象:/goannie 下载器 作者:融水公子 rsgz  goannie教程 goannie教程 http://www.rsgz.top/post/25 ...

  • Github中的fork作用 是否同步原仓库 怎么同步

    Github中的fork作用 GitHub中Fork 是 服务端的代码仓库克隆(即 新克隆出来的代码仓库在远程服务端),包含了原来的仓库(即upstream repository,上游仓库)所有内容, ...

  • git使用教程1-本地代码上传到github

    前言 不会使用github都不好意思说自己是码农,github作为一个开源的代码仓库管理平台,对代码的管理确实很方面. 问题来了:为什么越来越多的小伙伴喜欢开源的github? 答:因为我们可以免费下 ...

  • Kerloud mini Ardupilot飞控固件使用详解

    简介 Kerloud Mini是由云讷科技(深圳)有限公司发布的自驾仪产品,主要面向无人系统(如无人机.无人车等).作为一个受益于开源社区的开发团队,我们积极使产品能够兼容在世界各地被广泛使用的PX4 ...

  • 书源篇九

    书源篇九 爱阅书香语 别问我有啥不同,别问我为什么,就是突然想发个书源篇. 书源及工作原理 书源:一个网站的规则描述文件,可能包括有多个来源; 来源:聚合网站包括多个网站的内容,一个来源表示其中一个网 ...

  • Gitee 又一款超赞的开发神器问世,代号「Kooder」!

    Gitee团队 GitHubDaily 5天前 大家好,我是小 G. 随着 Git 这一代码版本控制工具的诞生,越来越多企业选择将项目代码托管至开源平台或自有部署服务器,并采用版本持续迭代的方式,在团 ...

  • Git最新版从零开始详细教程(迅速搞定~)

    目录 一.版本控制 1.什么是版本控制? 2.版本控制的作用 1. 追踪文件的变更 2. 并行开发 3.版本控制的内容 1. 检入检出控制 2. 分支和合并 3. 历史记录 4.常见的版本控制工具 5 ...