不会用git的机械工程师不是好厨子（指炼丹与炒菜）。
1 前言
1.1 为什么使用git？
稍等，我把代码拷给你，你带U盘了吗？
Git是先进的分布式版本控制系统。
上图的文件组织方式你可能会很熟悉，这是单人进行写作时产生的遗留文件。时隔多日，我无法再回想起每次更新版本时做出的具体改动，但又不得不保留这些单文件。要我找出某一版本特有的内容，无异于上青天。
我们再把规模扩大，涉及到版本合并、分支控制。如果是10人规模的小型团队进行软件开发呢？再拓展到Linux内核的开发呢？
Git不只适用于代码版本控制，它适用于任何需要版本控制的场景。近年来Gitbook成为了博客或团队文档的选择。据笔者的道听途说，某传统企业的文档支持系统由原本的企业OA系统docx文档，迁移至自建Gitbook，效果良好。
先不说Git，代码管理是必备技能，这是过于真实的现实原因。
1.2 什么是git？
git是用于Linux内核开发的版本控制工具。与CVS、Subversion一类的集中式版本控制工具不同，它采用了分布式版本库的作法，不需要服务器端软件，就可以运作版本控制，使得源代码的发布和交流极其方便。git的速度很快，这对于诸如Linux内核这样的大项目来说自然很重要。git最为出色的是它的合并追踪（merge tracing）能力。[1]
git的许可协议是GNU通用公共许可证 第二版，GNU宽通用公共许可证 2.1版。
1.3 git简史
git是由林纳斯·托瓦兹(Linus Torvalds)发起。在linux内核经过手工合并的阶段后，Linus于2002年选择了一个商业的版本控制系统BitKeeper，由BitMover公司授权使用。BitKeeper是商业软件，这也一直在社区中引起质疑，因为这不清真这和自由软件的主旨相违背。直到2005年，BitKeeper的著作权者对安德鲁·垂鸠(Andrew Tridgell)对BitKeep的逆向工程不满，收回BitKepper的使用许可。
协商未果，Linus决定自行开发版本控制系统。十天时间后，完成了第一个git版本[2]。
此时，一位技术力爆表的暴躁老哥呼啸而过（图文无关）。[3]
1.4 GitHub
太长不看：GitHub是通过Git进行版本控制的软件源代码托管服务。
GitHub里面的项目可以通过标准的Git命令进行访问和操作。同时，所有的Git命令都可以用到GitHub项目上面。
网站提供了一系列社交网络具有的功能，例如赞(star)、关注(follow)、评论。用户可以通过复刻(fork)他人项目的形式参与开发，并可通过协作示意图来查看有多少开发者参与了开发并追踪最新的复刻版本。此外网站还有Wiki（通过一个名为 gollum 的软件实现）等功能。
GitHub同时允许注册用户和非注册用户在网页中浏览项目，也可以以ZIP格式打包下载。但是用户必须注册一个账号然后才能进行讨论、创建并编辑项目、参与他人的项目和代码审查。[4]
Github分为付费账户和免费账户。对于免费账户，能创建公开的代码仓库；付费账户在此基础上可以创建私有的代码仓库。之前我也有一篇文章记录了申请Student Developer pack的过程，赠送1年期的高级账户权限。
1.5 关于本文
本文是在博主使用实际中总结的笔记。着重点多在于git的使用上，忽略了git背后的原理和实现。而且直接将Github作为实验Playground，是一篇实用向的笔记。其中参考了许多精品的教程资料[5]。其中，官方文档和书籍形式的教程是非常好的资源，详见https://git-scm.com/book/zh/v2。
2 开始使用
2.1 连接至Github
git是是一个分布式的版本控制系统，是可以使用远程仓库的。在这篇笔记的实验中，我们直接连接至Github作为远程仓库。
值得注意的是，Github的开放仓库对所有人都是可见的。几天前华住集团住宿信息被脱裤，或因程序员将数据库连接方式暴露在公开仓库中[6]。
1 创建SSH Key
经常通过SSH管理VPS的同学可能对SSH Key非常熟悉。SSH秘钥可以让用户更加方便安全地登录到SSH服务器，无需输入密码。[7]
首先生成自己的SSH秘钥对
ssh-keygen -t rsa -C "youremail@example.com"
生成完毕后能看到主目录下的.ssh文件夹包含id_rsa和id_rsa.pub。id_rsa是“私钥”，绝对不能泄露。id_rsa.pub是公钥，是可以在公网放心泄漏的。
2 在Github上添加SSH Keys
3 git初始化
$ git config --global user.name "Your Name"
$ git config --global user.email "email@example.com"
2.2 从GitHub新建库并克隆到本地
首先创建新的repository。
我起了个很俗的名字，就叫git-playground吧。
其中可以选择初始化README文件，然后选择许可证。许可证很重要，如果有志将项目发展下去，可以自己看下各开源许可的条款。
然后将库克隆到本地。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
pi@raspberrypi:~/git_playground $ git clone git@github.com:sptuan/git-playground.git Cloning into 'git-playground'... The authenticity of host 'github.com (192.30.255.113)' can't be established. RSA key fingerprint is XXXXXXXXXXXXX. Are you sure you want to continue connecting (yes/no)? yes Warning: Permanently added 'github.com,192.30.255.113' (RSA) to the list of known hosts. remote: Counting objects: 4, done. remote: Compressing objects: 100% (3/3), done. Receiving objects: 100% (4/4), done. remote: Total 4 (delta 0), reused 0 (delta 0), pack-reused 0 Checking connectivity... done. |
可以看到目录下拉下了刚才创建的库。
|
|
pi@raspberrypi:~/git_playground/git-playground $ ls -al total 20 drwxr-xr-x 3 pi pi 4096 Jul 17 08:19 . drwxr-xr-x 3 pi pi 4096 Jul 17 08:18 .. drwxr-xr-x 8 pi pi 4096 Jul 17 08:19 .git -rw-r--r-- 1 pi pi 1063 Jul 17 08:19 LICENSE -rw-r--r-- 1 pi pi 46 Jul 17 08:19 README.md pi@raspberrypi:~/git_playground/git-playground $ |
3 版本控制
3.1 提交更改
现在，我更改了工作目录下的README.md文件。
运行git status查看仓库状态：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
pi@raspberrypi:~/git_playground/git-playground $ git status On branch master Your branch is up-to-date with 'origin/master'. 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 将文件添加至仓库。
初次克隆某个仓库的时候，工作目录中的所有文件都属于已跟踪文件，并处于未修改状态。[8]
git stauts可以看到仓库文件状态。若要比较文件，可以用git diff
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
diff --git a/README.md b/README.md index 21d66a4..3abc867 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,4 @@ # git-playground Playground. Nothing special. +## Title +Now I am trying to edit this file. |
提交到仓库：
git add README.md
git commit -m ""
git push
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 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 |
pi@raspberrypi:~/git_playground/git-playground $ git add README.md pi@raspberrypi:~/git_playground/git-playground $ git status On branch master Your branch is up-to-date with 'origin/master'. Changes to be committed: (use "git reset HEAD <file>..." to unstage) modified: README.md git commit -m "commit-114514" pi@raspberrypi:~/git_playground/git-playground $ git commit -m "commit-114514" [master d899a30] commit-114514 1 file changed, 2 insertions(+) pi@raspberrypi:~/git_playground/git-playground $ ^C pi@raspberrypi:~/git_playground/git-playground $ git status On branch master Your branch is ahead of 'origin/master' by 1 commit. (use "git push" to publish your local commits) nothing to commit, working directory clean pi@raspberrypi:~/git_playground/git-playground $ git push warning: push.default is unset; its implicit value has changed in Git 2.0 from 'matching' to 'simple'. To squelch this message and maintain the traditional behavior, use: git config --global push.default matching To squelch this message and adopt the new behavior now, use: git config --global push.default simple When push.default is set to 'matching', git will push local branches to the remote branches that already exist with the same name. Since Git 2.0, Git defaults to the more conservative 'simple' behavior, which only pushes the current branch to the corresponding remote branch that 'git pull' uses to update the current branch. See 'git help config' and search for 'push.default' for further information. (the 'simple' mode was introduced in Git 1.7.11. Use the similar mode 'current' instead of 'simple' if you sometimes use older versions of Git) Counting objects: 3, done. Delta compression using up to 4 threads. Compressing objects: 100% (3/3), done. Writing objects: 100% (3/3), 354 bytes | 0 bytes/s, done. Total 3 (delta 0), reused 0 (delta 0) To git@github.com:sptuan/git-playground.git 92599e0..d899a30 master -> master pi@raspberrypi:~/git_playground/git-playground $ |
3.2 版本记录
我们先来对README.md进行多次修改和提交。
然后使用git log查看近三次提交。可以加上 --pertty=oneline。
具体参数可以参见https://git-scm.com/book/zh/v2/Git-%E5%9F%BA%E7%A1%80-%E6%9F%A5%E7%9C%8B%E6%8F%90%E4%BA%A4%E5%8E%86%E5%8F%B2
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 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 |
pi@raspberrypi:~/git_playground/git-playground $ git log commit 83c0ea033ee080de96d2667d79c4cf77e1c4ea3d Author: SPtuan <sptuan@steinslab.xyz> Date: Tue Jul 17 10:01:48 2018 +0800 +1919810 commit 01ad95d0a73a1f61a93de43d20d5c3899e9e5e55 Author: SPtuan <sptuan@steinslab.xyz> Date: Tue Jul 17 10:01:21 2018 +0800 +114514 commit d899a307a13ec67413ed1959a0c4fdb584fbd66f Author: SPtuan <sptuan@steinslab.xyz> Date: Tue Jul 17 09:45:34 2018 +0800 commit-114514 commit 92599e059341b18593bd67ad501bcae5b5f207f5 Author: SPtuan <sptuan@users.noreply.github.com> Date: Thu Sep 6 21:05:25 2018 +0800 Initial commit pi@raspberrypi:~/git_playground/git-playground $ git log --pertty=oneline fatal: unrecognized argument: --pertty=oneline pi@raspberrypi:~/git_playground/git-playground $ git log --pretty=oneline 83c0ea033ee080de96d2667d79c4cf77e1c4ea3d +1919810 01ad95d0a73a1f61a93de43d20d5c3899e9e5e55 +114514 d899a307a13ec67413ed1959a0c4fdb584fbd66f commit-114514 92599e059341b18593bd67ad501bcae5b5f207f5 Initial commit pi@raspberrypi:~/git_playground/git-playground $ |
3.3 版本撤销/回退
若提交后发现有若干改动没有添加，可以使用--amend选项尝试重新提交
git commit --amend
最终这次提交会代替上次提交结果
版本回退：
git reset --hard HEAD^
其中，git reset用于回退版本。虽然在调用时加上 --hard 选项可以令 git reset 成为一个危险的命令（可能导致工作目录中所有当前进度丢失！）
HEAD可以理解为一个版本的指针。进行回退时，指针直接指向回退的版本。
^表示上一个版本。
可以用git reflog查看回退版本指针情况。
对于后悔药，为git reset --hard commit_id
这里摘抄一段穆雪峰老师的评论：
假设一开始你的本地和远程都是：
a -> b -> c
你想把HEAD回退到b，那么在本地就变成了：
a -> b
这个时候，如果没有远程库，你就接着怎么操作都行，比如：
a -> b -> d
但是在有远程库的情况下，你push会失败，因为远程库是 a->b->c，你的是 a->b->d
两种方案：
push的时候用–force，强制把远程库变成a -> b -> d，大部分公司严禁这么干，会被别人揍一顿
做一个反向操作，把自己本地变成a -> b -> c -> d，注意b和d文件快照内容一莫一样，但是commit id肯定不同，再push上去远程也会变成 a -> b -> c -> d
简单地说就是你无法容易地抹去远程库的提交信息，所以本地提交怎么都行，push前想好了
使用 git revert <commit_id>操作实现以退为进，
git revert 不同于 git reset 它不会擦除”回退”之后的 commit_id ,而是正常的当做一次”commit”，产生一次新的操作记录，所以可以push，不会让你再pull
实验记录
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 |
pi@raspberrypi:~/git_playground/git-playground $ git reset --hard HEAD^ HEAD is now at 01ad95d +114514 pi@raspberrypi:~/git_playground/git-playground $ git reflog 01ad95d HEAD@{0}: reset: moving to HEAD^ 83c0ea0 HEAD@{1}: commit: +1919810 01ad95d HEAD@{2}: commit: +114514 d899a30 HEAD@{3}: commit: commit-114514 92599e0 HEAD@{4}: clone: from git@github.com:sptuan/git-playground.git pi@raspberrypi:~/git_playground/git-playground $ git reset --hard 83c0ea0 HEAD is now at 83c0ea0 +1919810 pi@raspberrypi:~/git_playground/git-playground $ git reflog 83c0ea0 HEAD@{0}: reset: moving to 83c0ea0 01ad95d HEAD@{1}: reset: moving to HEAD^ 83c0ea0 HEAD@{2}: commit: +1919810 01ad95d HEAD@{3}: commit: +114514 d899a30 HEAD@{4}: commit: commit-114514 92599e0 HEAD@{5}: clone: from git@github.com:sptuan/git-playground.git pi@raspberrypi:~/git_playground/git-playground $ |
3.4 工作区与暂存区
实际我们进行正常更新文件的目录就可以看做我的工作区。而在工作区下有一个隐藏目录.git，是Git的版本库。
|
|
pi@raspberrypi:~/git_playground/git-playground $ ls -la total 20 drwxr-xr-x 3 pi pi 4096 Jul 18 08:00 . drwxr-xr-x 3 pi pi 4096 Jul 17 08:18 .. drwxr-xr-x 8 pi pi 4096 Jul 18 08:00 .git -rw-r--r-- 1 pi pi 1063 Jul 17 08:19 LICENSE -rw-r--r-- 1 pi pi 107 Jul 18 08:00 README.md |
git中有个叫stage的暂存区，最开始时，还包含git自动创建的分支master，和指向master的指针HEAD。
git add 是将文件修改添加到暂存区，git commit是将暂存区所有内容提交到当前分支。
值得指出的是，git追踪的文件的修改。如果做出以下操作：
第一次修改 -> git add -> 第二次修改 -> git commit
commit后提交的是第一次修改的结果，因为git add将第一次修改放入了暂存区域。
若要撤销更改，可以使用
git checkout -- [file]
使工作区的该文件撤回到最近一次 git commit或者git add的状态。
若要删除文件，可先rm掉文件，再使用git remove。若要恢复误删文件，可使用git checkout -- [file]
3 分支
分支是非常重要的功能！可以把分支理解成一个一个的开发线。在各自有自己功能的分支上或多人协作分支开发，最后合并，安全便捷。
举个不恰当的例子，就像下图一样，只不过各个分支可以根据项目需要在最后合并。
图： 底特律:便乘人 剧情分支图（不恰当的例子）
3.1 创建与合并分支
实际上HEAD指针指向的是master。在我们之前的常规提交，master分支不断向前，HEAD指针也随着向前进。
现在我们创建新的分支，用于开发，起名为dev。
git branch dev
git checkout dev
在dev分支上不断commit，HEAD指向dev。
对于合并，最简单的的是将master指向dev。
Git鼓励大量使用分支：
查看分支：git branch
创建分支：git branch <name>
切换分支：git checkout <name>
创建+切换分支：git checkout -b <name>
合并某分支到当前分支：git merge <name>
删除分支：git branch -d <name>
将本地新创建的分支推送到github仓库。
git push origin dev
3.2 冲突解决
很容易想到，如果我们从master分支分出dev，那么dev和master都进行了新的commit，这样就需要我们解决冲突问题。
|
|
pi@raspberrypi:~/git_playground/git-playground $ git merge dev Auto-merging README.md CONFLICT (content): Merge conflict in README.md Automatic merge failed; fix conflicts and then commit the result. |
查看冲突：
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 |
pi@raspberrypi:~/git_playground/git-playground $ git status On branch master Your branch is ahead of 'origin/master' by 1 commit. (use "git push" to publish your local commits) You have unmerged paths. (fix conflicts and run "git commit") Changes to be committed: new file: G.I. Unmerged paths: (use "git add <file>..." to mark resolution) both modified: README.md |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
# git-playground Playground. Nothing special. <<<<<<< HEAD ## RA2 master - IFV 1 ======= ## RA2 - IFV - G.I. >>>>>>> dev |
看到了2个分支的冲突之处。
修改后使用git add该文件，可以提交。
之后的版本关系为
使用git log --graph
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 47 48 49 50 51 52 53 54 55 |
pi@raspberrypi:~/git_playground/git-playground $ git log --graph * commit 29d6136d1276224f3944d1467659609bcb229080 |\ Merge: dc4e3df 76cc090 | | Author: SPtuan <sptuan@steinslab.xyz> | | Date: Fri Sep 7 23:47:20 2018 +0800 | | | | conflict fixed | | | * commit 76cc090c3fd57349cdf6c8e0bc31aadf3b186108 | | Author: SPtuan <sptuan@steinslab.xyz> | | Date: Fri Sep 7 23:40:52 2018 +0800 | | | | Add G.I. | | | * commit 365220bd7df24007964c5d661bdd6f825923b4d4 | | Author: SPtuan <sptuan@steinslab.xyz> | | Date: Fri Sep 7 23:29:16 2018 +0800 | | | | Add G.I. | | * | commit dc4e3df1a9f5d28beb7cecd97d2b01a05b48189d |/ Author: SPtuan <sptuan@steinslab.xyz> | Date: Fri Sep 7 23:42:04 2018 +0800 | | Edit README | * commit 0b7cc5500872a215c36eda4b2925e1a0ab030c19 | Author: SPtuan <sptuan@steinslab.xyz> |
4 本文小结
本文是在博主使用实际中总结的笔记。着重点多在于git的使用上，忽略了git背后的原理和实现。
本文作为一个Start Up，暂时还不完整。
在下一期中，将补全以下内容
- 实际环境中的使用技巧
- 团队开发、多人协作注意点
- 可视化
- 在Visual Studio使用Git
参考资料
[1] git – Wikipedia https://zh.wikipedia.org/wiki/Git
[2] Git十岁了！Git之父Linus Torvalds说古，大谈Git开发秘辛 https://www.ithome.com.tw/news/95088
[3] https://linux.cn/article-640-1.html
[4] GitHub – Wikipedia https://zh.wikipedia.org/wiki/GitHub
[5] 廖雪峰的git教程 https://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000
[6] 华住旗下酒店5亿信息疑被泄，专家：或因华住程序员失误所致 – 澎湃新闻 https://baijiahao.baidu.com/s?id=1610052563948067365&wfr=spider&for=pc
[7] SSH keys – ArchLinux Wiki https://wiki.archlinux.org/index.php/SSH_keys_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87)
[8] Git-基础-记录每次更新到仓库 – git-scm https://git-scm.com/book/zh/v2/Git-%E5%9F%BA%E7%A1%80-%E8%AE%B0%E5%BD%95%E6%AF%8F%E6%AC%A1%E6%9B%B4%E6%96%B0%E5%88%B0%E4%BB%93%E5%BA%93
