• 如果您觉得本站非常有看点,那么赶紧使用Ctrl+D 收藏吧

使用git畅游代码的海洋

开发技术 开发技术 2个月前 (06-22) 41次浏览

如果把互联网上的纷繁代码比作一片海洋,那么git就是在这片海洋上航行的船只,正所谓“水可载舟,亦可覆舟”,git使用恰当可以远征星辰,不然可能会坠入无穷无尽的代码海洋无法自拔。书回正传,我们的征途是星辰大海!

扬帆起航

git的下载安装暂且不表,可参考网站https://git-scm.com/downloads。

git的安装只是个入门条件,下面如何使用git命令控制代码才是远征的基础。那么从何开始呢?让我们一步步说起。

要想扬帆起航,首先得有艘帆船吧。我们要在本地建立一个项目,之后将本地项目初始化为git仓库,可以使用

git init [–bare]

初始化本地项目,执行后会在当前执行目录下生成.git文件夹,这也就是我们的帆船了。[–bare]可选参数,可初始化裸仓库,裸仓库可以与源码项目分离,此时在当前目录下不会生成.git文件夹,而是直接生成.git文件夹下的包括hooks、info、objects、refs共四个文件夹和config、description、HEAD三个文件。

在初始化裸仓库后若想关联源码,只需进入hooks目录新建post-receive.sample文件,并添加如下内容:

git –work-tree=<project-dir> –git-dir=<local-url> checkout -f

其中<project-dir>为本地项目文件路径,<local-url>为本地git仓库路径。

 

对于当前目录下的.git文件夹所代表的本地仓库,不同的帆船有不同的配置,我们使用

git config –list

显示当前git配置。如果内容过多可以使用上下键翻页,查看结束按q退出即可。同时使用

git config –e [–global]

vim形式编辑修改git配置文件。

git config [–global] user.name “name”

形式修改指定配置,其中[–global]可选,为全局配置,name为用户名配置。

 

 

git仪表盘

 

 

 

 

 使用git畅游代码的海洋

 

 

图 1 Git指令关系图

 

建立git仓库作为帆船后,就可以在当前目录下任意使用git指令遨游了。我们需要先认识下git控制的命令仪表盘。

如图1所示,git整艘船主要分为四大区域,包括Remote远程仓库,Repository本地仓库,Index/Stage暂存区,Workspace工作区,不同区域之间可以使用相关指令进行代码操作。在上节使用git init创建的文件夹下,会生成名为.git的隐藏文件夹,四大区域的配置都储存在该文件夹下。其中在远程仓库和本地仓库中,储存有不同的branch分支,工作区和暂存区的文件只能针对某一分支进行修改提交操作,当然也可以使用分支操作指令对不同的分支进行增删合并等操作。

针对一些仓库的操作指令,使用前请务必保持头脑清醒,不然你的一个蝴蝶煽动翅膀似的操作,可能会引发仓库里的一场代码风暴,造成不可挽回的结果。

根据不同命令操作区域,可以将git命令大致分为全局显示信息、工作区与远程仓库交互、工作区与本地仓库交互、工作区与暂存区交互、暂存区与本地仓库交互、本地仓库与远程仓库交互、以及仓库内部分支操作。下面对这些命令进行了粗略的统计介绍,详细使用方式可参考git官方文档介绍,如有不足还请补充。

显示信息

git help [command]

获取命令的帮助信息。

 

git status

显示所有变更文件

 

git log [–stat] [–graph]

显示当前分支的版本信息。[–stat]参数指定显示commit发生变更的文件。[–graph]参数以数据图形式查看合并分支记录。

 

git blame <file>

显示文件的每一行最后修改的版本和作者

 

git show [commit][:filename]

显示某次提交的变更内容。其中[commit]为某次提交版本,也可在:后边加参数[filename]指定查看某个文件内容。

 

git diff [HEAD] [first-branch] [second-branch]

显示文件差异。无参时比较缓存区和上一次commit的差异;[HEAD]为工作区与当前分支最新commit的差异;或者两个分支之间的差异。

 

git reflog

显示已执行过的所有git动作日志。

 

工作区与远程仓库

git pull <remote> <branch>

拉取远程仓库的变化,并与本地分支合并。<remote>为远程仓库名,<branch>为远程仓库中的某一分支名。

工作区与本地仓库

git checkout [–b] <branch> [tag]

将暂存区切换到分支名。其中[-b]参数可选,当分支不存在时则创建,<branch >必须,为本地仓库分支,[tag]可选,指定切换到仓库分支中的某条标签,不标注则默认为切换分支的最近一次提交。

工作区与暂存区

git add <dir>

添加指定目录到暂存区,<dir>为添加路径,允许多个,包括子目录都会添加到暂存区中等待提交。

 

git rm [–cached] <file>

删除暂存区中的文件,<file>为暂存区中要删除的文件全路径,[–cache]可选参数,只会停止继续追踪指定文件,但该文件目前仍然保留在暂存区。

 

git mv <file-old> <file-new>

修改暂存区中的文件名,<file-old>为原文件全路径,<file-new>为修改后的文件全路径。

 

 

git tag

查看暂存区中的所有标签信息。

 

git tag –a <tag> [commit]

新建一个标签。[tag]为标签名;[commit]为指定的一次从暂存区到本地仓库的提交中,默认为最新一次提交。

 

git tag –d [tag]

删除本地标签。

暂存区与本地仓库

git commit [–amend] [–m <message>] [file] [-a] [-v]

从暂存区提交到本地仓库。其中[–amend]重做上次从本地项目到暂存区的commit,当代码与上次提交相比无变化时使用,只修改上次commit的<message>内容;[-m]参数为提交信息,<message>必写且详写,以区别提交代码的修改内容;[file]为指定暂存区中的文件;[-a]可直接提交项目中的变化到本地仓库,在没有新增文件时不需每次先git add提交到暂存区再提交到本地仓库;[-v]可以在提交时显示所有变化文件的diff信息。

 

git cherry-pick [commit]

选择一个commit版本合并到当前分支,[commit]为暂存区中的commit版本。

 

本地仓库与远程仓库

git remote [-v]

查看关联的远程仓库信息。[-v]可以查看详细信息。

 

git remote add <remote-name> <remote-url>

本地路径关联远程仓库。

<remote-name>必要参数,为远程仓库的名字,默认是origin。

<remote-url>必要参数,为远程仓库的地址,git服务器通常都是以.git结尾。

 

git remote remove <remote-name>

删除关联的远程仓库。其中<remote-name>为远程仓库的名字。

 

git push [remote] [branch] [–force]

推送本地指定分支到远程仓库。[remote]为远程仓库名,[branch]为本地分支名,[–force]为强制推送本地到远程,如有冲突则覆盖。

 

git fetch <remote>

将远程仓库拉到本地仓库。<remote>为远程仓库名。

 

git clone <url> [name]

创建一个本地仓库。<url>必须,可以是远程git服务器上的仓库,也可以是本地仓库。[name]选填是创建的新仓库名,默认与原仓库名一致。

 

分支指令

git branch [-r] [-a]

查看分支信息,无参只会查看本地仓库所有分支,[-r]是远程仓库所有分支,[-a]则是包括本地和远程仓库所有的所有分支。

git branch [branch-name] [commit]

在本地仓库新建分支,但暂存区仍然指向当前分支。其中[branch-name]为新建的本地仓库分支;[commit]可将分支指向指定commit版本。

 

git branch –track [local-branch-name] [remote-branch]

新建一个分支,并连接指定的远程分支。其中[local-branch-name]为本地仓库新建分支,[remote-branch]为远程仓库分支。

 

git branch –set-upstream [local-branch] [remote-branch]

连接本地仓库分支与远程仓库分支,其中[local-branch]为本地仓库已有分支,[remote-branch]为远程仓库分支。

 

git branch –d [branch]

删除本地仓库分支,[branch]为本地仓库中的已有分支。

 

git branch -m [branch-old] [branch-new]

修改本地仓库分支,其中[branch-old]为原分支,[branch-new]为改名后的分支。

 

git branch –dr [remote-branch]

删除远程仓库分支,[remote-branch]为远程仓库中的分支。不推荐使用,如果远程仓库未更新,可能会执行失败,推荐使用git push origin-delete [remote-branch]。

 

git merge <local-branch>

合并指定分支到当前分支,<local-branch>为本地仓库中的已有分支。

 

git rebase <remote-branch>

将当前分支的提交复制到指定的远程分支上,<remote-branch>为指定远程仓库中的已有分支。

 

git reset [–mixed|–soft|–hard] [commit]

重置仓库索引,重置一旦清空后的内容不会在仓库历史版本中留下历史记录。[–mixed]为默认参数,重置后只在工作区保留原节点修改文件,清空暂存区和本地仓库并均恢复到指定重置节点;[–soft]为软重置,重置后在工作区和暂存区均保留原节点修改文件,清空本地仓库并恢复到指定重置节点;[–hard]为硬重置,重置后均不会保留原节点修改文件。[commit]为要重置的节点号。

 

git revert [commit]

还原文件到之前修改提交节点时,会在仓库历史版本中留下历史记录。[commit]为要还原的节点号。

常规操作

git这艘大船虽然功能繁杂,但是用起来是有章可循的。入门之后就驾驶下这艘大船来试试吧。

一般git有三种工作流程,包括Git flow,项目存在两个长期分支(主分支master开发分支develop),适用于基于版本发布的普通项目;Github flow,只有一个长期分支(主分支master),适用于持续发布的小型项目;Gitlab flow,项目存在多个长期分支,其中主分支master是其他所有分支的上游,只有上游分支采纳的代码才能应用到其下游分支,适用于长期维护的大型项目。

图2展示了一次项目git流程演变过程,在master主分支上有Tag1-Tag4四次代码更新,其中基于Tag2对应的版本1号创建了新的branch1分支,新分支创建后自动生成了版本2号并打上了Tag2-1标签,之后master主分支和branch1分支都同时进行了代码演变,在branch1分支提交的版本4号及标签Tag2-3之后,branch1分支合并到了master主分支,合并前master主分支位于版本5号,合并后可能重新生成版本6号,并打上新的tag4标签,之后master主分支修改提交为版本7号,而branch1分支则停留在tag2-3标签的位置处。

 

 使用git畅游代码的海洋

 

 

 图 2 Git流程示意图

 

在这份项目流程中,分支创建之后,可能在不同的阶段修改提交文件,根据对文档的读取权限范围,我们可以形象地将这些阶段划分为三种身份类型,船长、水手和游客。船长身份,作为项目管理者,主要负责远程仓库和本地仓库之间的分支操作,协调分支冲突;水手身份,作为项目贡献者,主要负责某一分支的迭代更新;游客身份,作为项目使用者,只是访问使用仓库及其分支内容,不能提交任何修改。同一人在项目的不同阶段可以是其中任意一种身份,下面以这三种身份为维度简单介绍下使用到的相关git指令步骤,并辅以示意图方式直观解释git指令执行前后git项目变化。

 

 

项目使用者-游客

        作为git项目的游客,当然只能将项目从远程仓库拉取到本地使用,期间除了切换仓库分支外不会涉及其他远程操作。

 

git pull origin master

拉取远程仓库origin的master分支到本地。

 

git checkout branch1 tag1

切换到分支branch1。

 使用git畅游代码的海洋

 

项目贡献者-水手

        作为项目的水手,除了可以使用游客的功能指令外,还会涉及到修改工作区文件,并将工作区文件提交到暂存区和仓库等任务。通常水手只需要维护仓库中的某一条分支并只对该分支负责,因此水手更注重工作区的代码文件修改工作。

 

git pull origin dev:branch1

拉取远程仓库origin的dev分支到本地,并与本地branch1分支合并。工作区中文件即显示branch1分支,可在工作区做文件修改操作。

 

git add .

在工作区的文件修改之后,可先添加当前目录所有文件到暂存区,之后可继续修改工作区其他文件,也可将暂存区文件提交到本地仓库。

 

git rm –cached file

针对工作区编译生成的配置file文件,一般不需提交到仓库,可使用该命令将file文件从暂存区删除并停止后续追踪。另外一种添加忽略文件的方式,在.git文件夹的同级目录下新建.gitignore文件,在该文件中根据规则增加要忽略的文件路径,之后将该文件提交到本地仓库中。

 

git commit –m “commit message 1”

在确保工作区的所有修改文件均已提交到暂存区后,便将暂存区的修改提交到本地仓库,同时附带当次提交信息。每次提交都会在本地仓库生成一个新的提交commit版本号,由于提交的commit版本号是冗长的sha1码,所以为了方便后期溯源,通常会在主要的commit号版本上再打一个鲜明的标签以作标记。

 

使用git畅游代码的海洋

 

 

git tag tag1 1

在提交的commit版本号为1的节点上打标签,打上标签后的commit号便可使用简短的标签名tag1访问,以便后期对该节点溯源。

 

使用git畅游代码的海洋

 

 

git push origin branch1:dev –tags

将本地branch1分支及相关标签推送到远程仓库origin的dev分支。如果本地branch1分支已经与远程dev分支建立追踪关系,也可直接使用

git push origin branch1 –tags

指令。

 

git branch –set-upstream-to=origin/dev
branch1

设置本地仓库的branch1分支与远程仓库origin的dev分支的追踪关系。通常从远程分支pull到本地的分支都已经建立了追踪关系,不需要手动修改。

 

git branch –vv

查看本地分支及追踪的远程分支信息。

 

项目管理者-船长

        作为项目的船长,自然拥有整个git这艘大船的项目所有权限,除了使用水手的操作指令外,另需完成分支增删合并等任务。通常船长是项目仓库的创建者,负责管理维护仓库的各分支关系,对项目的整个仓库负责,因此相较于水手,船长更注重仓库的分支管理相关工作。

 

git clone https://github.com/xxx.git -b dev

克隆远程仓库的dev分支到本地,默认会将文件更新到本地仓库建立的同名dev分支。

 

git checkout –b branch1 origin/dev

在本地仓库新建branch1分支,与远程仓库origin中的dev分支对应,并在本地切换到branch1分支。如果不指定远程仓库及分支信息origin/dev,则默认从本地仓库dev分支创建。至此可以切换为水手身份,从该分支更新代码,并将修改文件提交到该branch1分支。

 

git add .

git commit –m “modify file commit”

在完成对工作区文件的修改之后,使用水手身份将工作区的修改提交到本地branch1分支。

 

git checkout dev

切换到本地仓库的dev主分支,作为本地仓库与远程仓库代码合并的操作分支。

 

git fetch origin dev

拉取远程仓库origin中的dev分支到本地仓库当前dev分支

 

git pull

将本地仓库dev分支的文件修改合并到工作区。

 

git merge branch1

将本地仓库的branch1分支合并到当前dev分支。如果当前dev分支与branch1分支有冲突,需要根据冲突文件提示分别修改,之后再重新合并该分支。

 

git checkout branch1 build/files

或者只将branch1分支的build/files目录下所有文件合并到本地仓库的当前dev分支。同样需要做冲突处理。

 

git push origin dev:dev –tags

向远程仓库origin中的dev分支并推送本地仓库dev分支。推送时如果确认以本地分支覆盖远程分支,则可使用

 

git push —force origin dev:dev –tags

强制推送。最后如果想删除远程分支,有以下两条指令

 

git push origin –delete dev

git push origin :dev

这两种方式都可以删除指定的远程仓库origin中的dev分支。

 

应急预案

上面的图2Git流程图简单涉及了一次版本演变过程中的一些git信息,包括分支切换,打标签等,看上去简单易懂,而实际我们工作中驾船航行时却并不总是风平浪静。

        通常出现的紧急情况需要修改分支版本,包括变基、还原、重置等操作,针对不同场景需要选择不同的操作方式。

变基

git rebase master

变基会将当前分支的修改文件复制到master分支,同时创建新的commit版本号并修改项目的历史记录。当master分支已经更新,且确认当前分支与master分支没有冲突,那可以使用变基以便当前分支获取master分支的更新。

 

使用git畅游代码的海洋

 

 

 

重置

git reset 1

将HEAD重置到历史提交版本1的状态,还原仓库和暂存区的文件与提交版本1一致,工作区维持修改文件状态。

 

使用git畅游代码的海洋

 

 

 

还原

 

git revert 1

重新创建一次提交版本节点,文件状态与历史提交版本1一致,工作区、暂存区与仓库均保持一致。提交版本2相对于提交版本1新增了file.txt文件,执行该指令后,在提交版本3中将恢复到提交版本1的状态,因此提交版本3相对于提交版本2则删除了file.txt文件。

 

使用git畅游代码的海洋

 

强制远程覆盖本地

git fetch –all

拉取远程所有仓库到本地仓库,工作区不会有任何合并更新。

 

git reset –hard origin/dev

把工作区HEAD指向最新的远程仓库origin中的dev版本。

待补充

除此之外在驾驭git这艘大船时肯定还会出现各种意外,届时将酌情补充。

 

 

 

使用git畅游代码的海洋


喜欢 (0)