该教程对该文章的翻译:https://git-scm.com/docs/gittutorial
本文介绍怎用使用 Git 导入新的工程、修改文件及如何其他人同步开发。
首先, 可以使用以下指令获取文档帮助
git help log
笔者注:不建议看这个文档,标准的语法介绍格式,很不友好
可以使用指令
git log --graph
查看提交过程
笔者注:不过也不建议使用,虽然优点GUI感觉,但毕竟是命令行输出。建议安装个GitKraken,才是真的方便。
在开始任何开发之前,建议线配置用户名和邮箱,例如
git config --global user.name "Your Name"
git config --global user.email "you@yourdomain.example.com"
笔者注:这个配置是全局有效的,就是整台电脑都有效,配置保存在 ~/.gitconfig 文件里。上面的名字和邮箱就是注册Github/Gitee/Gitlab 的用户名和邮箱。
导入新的工程
先只考虑在本地进行开发,想要在代码开发过程中进行版本管理。有一个压缩文件 project.tar.gz
,解压并且进行Git初始化
tar xzf project.tar.gz
cd project
git init
Git将会输出
Initialized empty Git repository in .git/
通过初始化,会产生一个文件夹 .git
,git相关的东西会存在里面。
接下来,可以将当前路径下的所有文件(用 .
表示)进行暂存(原文用 take a snapshot,翻译成快照太别扭了)。
git add .
这个暂存操作会将文件暂时放在一个叫做索引表(Index)的地方。如果想要长久保存,那么就执行
git commit
笔者注:这个命令会打开编辑器,写入自己的Comit,实际上直接用
git commit -m "commit 内容"
更方便。
暂存(仅add)和提交(commit)的区别是什么呢?可以这样理解,比如写错了,要返回之前写的内容,要么返回到原始内容,要么返回add完毕的结果。但是如果commit了,可以直接跳到每一次commit的时候。
修改文件
如果修改了一些文件,就把它们加入到索引表中,
git add file1 file2 file3
add完毕,准备提交,可以使用 git diff --cached
来查看当前已add的东西与上一次commit后的差异
git diff --cached
如果不加参数 --cached
,那么就是查看当前未add的东西与上一次commit后的差异了。git status
指令也可以查看当前的修改
git diff
git status
git add
的逆操作是git restore
注:增删改 都是修改。
对于很多IDE,例如VScode,修改了的地方也会有标注,可以跟上述指令输出对比加深理解。
如果确定要提交,那么继续执行 git commit
即可。
也可以把 add 和 commit 合并成一条指令
git commit -a
不过一般都分开来。
查看提交历史
任何时候都可以使用以下指令查看修改
git log
如果想要很详细地比较每一步提交的差异,使用指令
git log -p
但是通常就是简单看以下每一步的修改,常用指令
git log --stat --summary
分支管理
一个Git仓库能够维护很多个分支,创建一个新的分支,例如 experimental
,使用
git branch experimental
查看分支使用指令
git branch
就可以输出所有分支,例如
experimental
* master
experimental
是刚才创建的,而 master
是默认的分支。
在
master
上创建experimental
,两者是一致的,相当于只是别名,改一个另一个也跟着修改,直到commit后才会各走各的。
切换到experimental
分支使用
git switch experiment
现在修改一下文件,并且add和commit
git commit -a
现在如果执行指令 git switch master
切换到分支 master
,就看不到自己的修改,因为修改是在 experimental
上进行的。如果切换到 experimental
,又会重新看到修改。
在 master
分支上修改文件内容,并且commit(默认已经add),那么从此两个分支就是完全不一样的了,会产生分歧(diverge)。此时,就需要合并(merge)代码,将所有修改合并在一起。
例如,将 experimental
合并到 master
,由于当前已经在 master
分支上,因此使用以下指令进行合并
git merge experimental
如果修改没有冲突(conflict),那么会自动完成合并。但是如果有冲突,就需要决策选择哪个分支的内容了。
没有冲突例如在
master
中将变量 a 从0改为1,在experiment
分支中将变量 b 从 0 改为2,那么合并后 a 为1,b为2。
有冲突例如master
中将变量 a 从0改为1,在experiment
分支中将变量 a 从 0 改为2,那么两个分支修改不一致。
可以使用
git diff
查看冲突。然后在IDE(例如VScode)中选择要保留的内容解决冲突问题。例如:
如果要取消合并,使用
git merge --abort
,在commit前可以取消,commit后就直接回退版本吧。
现在 experimental
的内容已经合并过来了,可以删除该分支了。删除分支使用指令
git branch -d experimental
有时要强制删除一些分支,可以是使用指令
git branch -D experimental
使用Git合作开发
假设小明新建一个Git仓库 home/ming/project
,小华也在根目录下克隆该仓库
hua$ git clone /home/hua/project myrepo
新仓库 myprepo
是对小明创建的仓库的复制版本。现在小华开始修改文件,并且提交。当小华完成自己所有开发时,就需要传给小明进行合并,小明的操作如下
ming$ cd /home/ming/project
ming$ git pull /home/hua/myrepo master
这实现将小华的代码合并到小明的 master
分支上。如果小明自己也做了修改,有冲突的话小明就得手动解决了。
pull
的功能有两个,一是从远程拉取(fetch)修改,二是与当前分支进行合并(merge)。