求知 文章 文库 Lib 视频 iPerson 课程 认证 咨询 工具 讲座 Modeler   Code  
会员   
 
  
 
 
 
   
分享到
Git 系列
 

作者:王聪明;发布于2013-2-19

 

Git 系列之一:版本控制的概念、分布式、Git 简介及其工作流程

UPDATE:这里记录的“Git 工作流程”比较适合于团队大部分人没有使用过 Git 的情况,能够简单无障碍入门;以及,适合于系统比较大,不同的人工作于不同的部分,彼此进度不一的情况。日志写作时,我们正好符合这两个情况,所以采用了所述的流程。随着时间的推移,团队成员使用 Git 已经比较熟练,而我们系统的开发也逐渐成熟,现已转用了另一种流程。

——

注:

Git 的强大、灵活、好用,毋庸置疑。

但也正是 Git 的灵活性,在公司推行时,如何执行统一的流程成为一个问题。我想了不少时间才制订出一个办法。

目的是规范、统一。还有就是,Windows 下的同事,特别是不熟悉命令行的同事,怎样才能使他们好理解,并且觉得简单(之前大家觉得概念太多,难以理解;步骤多,记不住,不小心就搞错,冲突频发)。

说到 Windows,Git 在 Windows 下不如 Linux 下好使,这也是一个需要考虑的问题。

同样是在公司 Wiki 上写的,再次拿到 Blog 来凑数呵呵~。

版本控制

简单地说,就是将在本地开发的代码,定时推送到服务器。每一次修改,记录下它的作者、时间及修改说明等。

相对的,我们也可以从服务器下拉其他人推送的代码,并了解它的作者、时间、修改说明及其具体的修改内容。

这样,版本控制给团队协作开发提供了极大的方便。即使是一个人开发,因为它记录下了我们整个的开发历史,也是极有帮助和价值的。

比如,如果某次修改甚至整个系统出现问题,它也能帮助找回我们珍贵的代码。

分布式版本控制

更进一步,分布式版本控制工具使得我们在本机上即拥有完整的功能,不依赖于服务器,使用更为方便。它们往往也提供其它更好用或更强大的功能,比如灵活的分支管理。

Git

Git 是 Linux 之父 Linus Trovalds,为管理 Linux 内核代码而建立的,被认为是分布式版本控制工具中的顶级水准。智能、友好、强健、高效。

Git 工作流程

  1. 使用中央服务器辅助协作;
  2. 每人在服务器拥有一个以自己 id 为名称的分支;
  3. 各人只许推送更新到自己的分支,不允许推送到别人的分支或者 master;
  4. master 由专人管理,在合适时 merge 其它分支(开发初期每日自动 merge 各人分支,生产化后则由人工 merge 经过 review 的分支);
  5. 代码修改 merge 到 master 后,将同步到所有终端。

【TIP】:熟悉之后,你可以创建类似 myId_branchName 的其它分支。

【TIP】:以上只是概念介绍,至于具体的操作,请参考:《Windows 下 Git 配置与使用指南》《Git 进阶功能》

Git 系列之二:Windows 下 Git 客户端的选择,及 msysGit 各种中文问题的解决

在 Windows 下用 NetBeans 做 PHP 开发,首先想到的是 NetBeans 的插件:NBGit。

评价:能用;若需没有的功能,可以自定义菜单调用自定义 bat 脚本;开发不活跃,使用没有信心。

第二个则是:TortoiseGit,SVN 小乌龟的 Git 版本。

评价:该有的功能基本都有了,还是不错的。

另外,TortoiseGit 只是 GUI 工具,使用它需要先安装 msysGit,这是正宗的 Git 之 Windows 版本。msysGit 有个简单的 GUI 工具,及简单的 Explorer 集成;但它自带的 Bash 非常好用,深得 Linux 的真传。

选择:msysGit。

理由:

NBGit 不用说,功能都不完善,还需要自己定制 bat 脚本(若此,则它同样要依赖 msysGit);开发不活跃,很可能 NetBeans 下个版本更新就不能用了;况且,我们还有别的项目,不使用 NetBeans。

TortoiseGit 从功能上说是完善的,但它只是功能的堆砌而已,使用时完全体会不到 GUI 带来的便利。相反,它让人感觉很繁琐,一个劲地点鼠标,点来点去全是跟菜单打交道,远离了 Git 命令、远离了 Git 输出提示、远离了真相。

msysGit 的 Bash 非常好用;加上 Git 强大的 alias 功能,我们完全可以自定义一个 $ git go,使得 90% 的情况下只需要这一个命令,即使是不熟悉命令行的 Windows 用户也会觉得很好玩;因为 NBGit、TortoiseGit 都需要 msysGit 做底层,我们直接用底层工具也避免了上层 GUI 带来的额外的 bug。

需要的配置:

1、C:\Program Files\Git\etc\git-completion.bash:

alias ls='ls --show-control-chars --color=auto'说明:使得在 Git Bash 中输入 ls 命令,可以正常显示中文文件名。

2、C:\Program Files\Git\etc\inputrc:

set output-meta on

set convert-meta off说明:使得在 Git Bash 中可以正常输入中文,比如中文的 commit log。

3、C:\Program Files\Git\etc\profile:

export LESSCHARSET=utf-8说明:$ git log 命令不像其它 vcs 一样,n 条 log 从头滚到底,它会恰当地停在第一页,按 space 键再往后翻页。这是通过将 log 送给 less 处理实现的。以上即是设置 less 的字符编码,使得 $ git log 可以正常显示中文。其实,它的值不一定要设置为 utf-8,比如 latin1 也可以……。还有个办法是 $ git –no-pager log,在选项里禁止分页,则无需设置上面的选项。

4、C:\Program Files\Git\etc\gitconfig:

[alias]

go = “! bash -c \”git pull && git add .; if [ \\\"$*\\\" == \\\"\\\" ]; then git commit -a; else git commit -am \\\”$*\\\”; fi; git push origin master:your-id;\”"

说明:强大的 alias,有了这个,我们 90% 的情况下只需要输入 $ git go 这一个命令,免去了先拉后提交再推的繁琐步骤。

两种用法:

$ git go

$ git go aaa 修订说明

命令后带修订说明时,会直接提交。需要注意的是,在“修订说明”之前,有还个“aaa”,这是个 bug,参数中的第一个会被忽略,所以随便写一个凑数的……。

若命令行里没有提供修订说明,则会自动弹出一个编辑器,等待输入。默认的编辑器是 Vim。Vim 的使用是很简单的,首先要明白它有两个模式,一个是命令模式、一个是输入模式。Vim 启动的时候默认的是命令模式,需要先按’i'键,进入输入模式;然后就正常编辑;编辑完成之后,将输入法切换回英文状态,按 Esc 重新进入命令模式;此时按 ‘(Shift):wq‘ 并回车,w 表示写入保存、q 表示退出。完毕!

若实在不习惯 Vim,也可以设置为其它编辑器:

$ git config --global core.editor "notepad"其中 notepad 可以替换为更好用的 wordpad、notepad++ 等(不过它们在命令行里无法直接访问,得先设置 PATH 变量)。

以上 alias 是为 Windows 定制的,Linux 下可以写得更优雅,不过鉴于使用上没分别,就保持一致吧~。

[gui]

encoding = utf-8

说明:我们的代码库是统一用的 utf-8,这样设置可以在 git gui 中正常显示代码中的中文。

[i18n]

commitencoding = GB2312

说明:如果没有这一条,虽然我们在本地用 $ git log 看自己的中文修订没问题,但,一、我们的 log 推到服务器后会变成乱码;二、别人在 Linux 下推的中文 log 我们 pull 过来之后看起来也是乱码。这是因为,我们的 commit log 会被先存放在项目的 .git/COMMIT_EDITMSG 文件中;在中文 Windows 里,新建文件用的是 GB2312 的编码;但是 Git 不知道,当成默认的 utf-8 的送出去了,所以就乱码了。有了这条之后,Git 会先将其转换成 utf-8,再发出去,于是就没问题了。

以上,给 Windows 下的同事在 Git Bash 里推代码就比较完美了。不过仍然有 3 个问题:

1、上面的 alias $ git go 有 bug,代码修订说明之前要输入一串字符凑数;

2、$ git diff,如果代码里有中文,会显示乱码;

3、$ git checkout 有时候需要修改/增删很多文件,如果某些文件被占用,会被 Windows 拒绝,导致失败,甚至可能造成版本库出现无法修复的问题。

这 3 个都是可承受的问题,前两个应该有办法解决;第 3 个归功于文件系统,只能尽量避免 checkout,实在需要的时候先注销一次,就不会有问题了。

【TIP】该文只是解释说明,具体操作请按《Windows 下 git 配置与使用指南》Wiki 执行。

Git 系列之三:Windows 下 Git 配置与使用指南

一、安装

默认安装:msysGit

二、配置

1、C:\Program Files\Git\etc\gitconfig 添加:

【注意!】请将第二行最后的 “your-id” 修改成你在服务器上的实际 id,默认是姓名拼音。

[alias]
    go = "! bash -c \"git pull && git add .; if [ \\\"$*\\\" == \\\"\\\" ]; then git commit -a;
 else git commit -am \\\"$*\\\"; fi; git push origin master:your-id;\""
[core]
    autocrlf = false
[gui]
    encoding = utf-8
[i18n]
    commitencoding = GB2312
[user]
    email = xxx@gmail.com
    name = 某某某

2、C:\Program Files\Git\etc\inputrc 修改两行为:

set output-meta on

set convert-meta off3、C:\Program Files\Git\etc\git-completion.bash 末尾增加:

alias ls='ls --show-control-chars --color=auto'4、C:\Program Files\Git\etc\profile 末尾增加:

export LESSCHARSET=utf-8【TIP】以上文件最好使用支持 unix 格式的编辑器修改(如 Notepad++、NetBeans),最次也用“写字板”而非“记事本”。

【TIP】若想了解为什么这样设置,请参见:Windows 下 Git 客户端的选择,及 msysGit 各种中文问题的解决

三、生成密钥

安装完后,需要生成一对 Key(这里指密钥),然后才能通过加密的方式和服务器的代码库取得同步。

到开始菜单,找到“Git Bash”,运行之,并执行以下命令:

$ ssh-keygen -t rsa程序会提示您输入密钥的文件名,直接按回车即可。

然后会要求你输入一个密码,将来在使用密钥的时候需要提供这个密码。可以输入,也可以不输入直接回车(无论输入还是不输入,都会要求你确认一次)。

确认完毕后,程序将生成一对密钥存放在以下文件夹:

C:\Users\Administrator[这里替换成你的用户名]\.ssh密钥分成两个文件,一个私钥(id_rsa)、一个公钥(id_rsa.pub)。
私钥保存在您的电脑上,公钥交项目负责人添加到服务器上。用户必须拥有与服务器公钥所配对的私钥,才能访问服务器上的代码库。

【注意!】为了项目代码的安全,请妥善保管你的私钥!因为一旦私钥外泄,将可能导致服务器上的代码被泄漏!

四、使用

1、克隆代码库

使用 Windows 资源管理器,打开你打算存放项目代码的文件夹,点右键选择 Git Bash。

在我们的项目管理系统中,每个项目的首页,都有写明代码克隆的地址,比如我们用于测试目的的沙盒项目:

$ git clone your-name@testing.aysaas.com:/var/projects/sandbox在 Git Bash 中运行这条命令就能将沙盒项目中的所有代码(其实只是几个随便测试的文件)克隆到本地。

接着您就可以打开习惯的 IDE(如 NetBeans),投入到项目的开发中啦~!

【TIP】上面命令中的 your-name 要改成你在服务器上实际的用户名。

2、查看修改差异

开发过程中,如果你想了解修改了哪些代码,总览所有代码的改动情况,可以在 Git Bash 中输入此命令:

$ git diff【TIP】Git Bash diff 的时候有两个缺点:一、窗口太窄,可能显示不下整行的代码;二、如果代码中有中文,会乱码。如果你碰到这两个问题,可以在项目文件夹下点右键,选择 Git Gui。

3、提交修改

每当完成一个阶段的代码,就需要提交代码以记录进展,方便日后查找问题以及团队协作。

$ git go aaa 修改说明(改动了什么?为什么这样改?)【TIP】别忘了 go 后面的 aaa,关于 ‘git go’ 命令的详细说明,请参见 Windows 下 Git 客户端的选择,及 msysGit 各种中文问题的解决

【TIP】请尽量养成勤提交的好习惯。当代码不幸出现问题时,比较容易找出从什么时刻开始出现问题,并回退到该时刻进行调试,最大限度保护已完成的阶段性工作。

【TIP】以上命令,都需要在项目目录下运行。Git Bash 在命令提示符前,会显示当前所在的目录。如果当前不在项目目录之下,需要用 cd 命令切换到项目所在目录。

简单的办法,就是先在资源管理器里打开项目文件夹,再点右键,选择 Git Bash。

五、总结

至此,从获取代码、查看差异、到提交代码,整个流程都熟悉了。Git 还有比较高级的技巧,大家可以参考 Git 进阶功能 或在线找进一步的资料学习。

Git 系列之四:Git 进阶功能

【TIP】在我们的《Windows 下 Git 配置与使用指南》 中,有介绍大家使用 $ git go 命令。其实,这并非 Git 的原生命令,它是我们自定义的一个 alias(别名),由 $git add、$git commit、$git push 和 $git pull 四个命令组合而成。待熟悉之后,你可以直接使用这些原生命令,或者自定义更适合自己的 alias。

add

添加新文件到 Git 代码仓库的索引中

$ git add filenamemv

mv

移动或重命名文件

$ git mv old-filename new-filenamerm

rm

从工作目录和 Git 代码索引中删除文件

status

$ git rm filenamestatus

查看目前工作目录的代码状态,自上次提交以来的添加、修改和删除等

$ git statusdiff

diff

查看自上次提交以来,本地代码改动的具体情况

$ git diffcommit

commit

提交修改的代码(只是提交到本地的代码库,不会推送到服务器)

$ git commit -am '修改说明'如果觉得刚提交的“修改说明”写得不够好,可输入以下命令调整

$ git commit --amendpush

push

将自上次 push 以来的,本地历次 commit,推送到服务器

结合我们的实际,应该这样写:

$ git push origin master:your-id其中,master 是本地的分支名;your-id 填你在服务器上的 id,服务器的版本库里会有以你的 id 为名称的分支。

pull

将别人推送到服务器的代码,拉到你的机器里

$ git pulllog

log

查看修改记录,含作者、时间、修改说明等

$ git logshow

show

显示具体的代码改动情况

显示最后一次 commit 修改的内容:

$ git show显示指定 commit 修改的内容:

【TIP】git log 命令中,每条 commit 会有一长长的字符串,此即 commid id,取其前面五六位即可。

$ git show commit-idbranch

branch

分支管理

列出所有分支(当前所在分支前会有“*”号):

$ git branch新建分支:

$ git branch 新分支名删除分支:

$ git branch -d 欲删除的分支名【注意!】不要把 ‘-d’ 写成了 ‘-D’,危险!

-d:要求:被删除分支的所有修改,已经合并到当前分支; -D:直接删除,未合并的代码,将被丢弃! checkout

checkout

恢复某个已修改的文件(撤销未提交的修改):

$ git checkout file-name切换到另外的分支,进行开发:

$ git checkout branch-name【注意!】该命令可能伴随大量的文件增删/修改。Windows 下,改动已被占用的文件可能会被拒绝,导致版本库出现严重问题。如果确实要这样做,安全起见,最好先注销一次。