2.1   预备知识

• Git版本管理的基本理念

  • 免费
  • 分布式
  • 版本控制系统

• Git的客户端管理工具 [1]

关于Git版本管理的基本理念，可以直接看官方文档 [2] ,各国语言都有，自然也少不了中文 [3] ，但是建议英文好的同学，直接阅读英文原版，这样有助于理解命令。如果喜欢看出处的纸质教程的，国内也相应的出版物：《Git权威指南》 [4] 可以参考。

由于Git的理论和操作是属于工具型的，最好的办法就是多在项目中磨炼，熟练即可，其实常用的功能了并不多，上手也不难。

本文中使用的客户端管理工具是：Linux平台下的git工具。

在Linux下安装git客户端很容易，只需要在机器联网状态下，使用如下命令即可：

sudo apt-get install git

如果在Linux Desktop里面需要可视化界面，则安装：

sudo apt-get install gitk

2.2   预备平台

在掌握了基本的git的版本管理理念之后，就需要实地操作了。所幸的是，对于普通的个人或者小团队开发者，已经有成熟稳定的git公共服务提供商。普通开发者，不用去搭建git的服务器及服务管理系统，就可以轻松便捷的享受到git的远端备份和协作服务了。

因为项目版本管理及项目交流协作的重要性，国内外已经有很多相当成熟的 git 公共服务了。

国际上有：

• GitHub
• Bitbucket

国内有：

• 开源中国 git@osc

关于以上几类服务的选择，可以参考如下规则：

• 如果想国际化，又有开放精神的，请选择Github，仅对开源项目免费支持
• 如果想国际化，想建立私有项目的，请选择Bitbucket，个人团队可以免费建立私人项目
• 如果想获得更多的私人项目的权限，请选择 git@osc，支持1000个免费项目，不限制私有或公有。

由于在 IT 界， Github 基本上成为了程序员的精神圣地，成为了git的代码名，所以对于初入此门的用户来说，最好也要在 “行业圣地” 安营扎寨。

只需要完成如下两个步骤，就可以使用 Github 提供的服务了：

• 注册一个 Github 的账号
• 创建一个 Github 项目主页

而更高级的全球化 "码农" 社交，还至少需要如下动作：

• Watch一个大牛的项目，时刻关注动态，紧跟步伐
• Fork一个项目，自己修改，成为社区贡献者

下面将以 Github 对具体对象，来讲解如何使用git工具来

本文 GitHub 项目示例

gt-java-sdk

3.1   源码

这个的重要性就自然不用说了。既然是开启了代码项目，项目就一定会有它的作用。

一般是如下一个或者几个作用：

• 个人兴趣练手
• 存储和记录某些信息，比如文档
• 为某个需求提供生产力
• 提供某种功能的开源解决方案，服务大众
• 其它。。。

IT界流传过这样一句极端的话： 不产生生产力的代码实际上和垃圾没有什么区别 。 这句话有些极端，毕竟有时候出于学习和兴趣的代码也其实也有它的存在意义的。总之，话不多说，这些话不管极端还是中肯，其实主要是表达一个意思：你要让做的事情有它的价值，你才会有动力长久维护下去，而一般情况下，源码就是最基本的IT项目的价值体现载体。

示例项目中的价值体现就在于java的源码项目，解决的问题就是：提供一种验证服务的部署SDK。而且这个项目一直在随着业务升级在不断的迭代更新，已经部署到N多服务器上，持续的产生着生产力，所以有人Wathc,Star这些都不奇怪了。

3.2   项目简介

项目简介，就是项目源码的 “配套” 设施。是一种最快速让别人了解你项目的向导说明。在 Github 中的体现就是ReadMe。

这里面的项目简介，还不是像wiki那样的重试文档系统，而是在项目根目录下的 ReadMe 文本文档。一般的Git的公共服务提供商，例如：Github ， Bitbucket 都会默认将项目根目录下的 ReadMe 文件进行渲染，以主页文档的方式呈现出来。

项目简介支持两种渲染格式：

• Markdown

  • 优点

    语法简单，上手容易，适合写小型博客文摘

  • 缺点

    支持的语言特性有限，不太适合开发大型文档系统

• RestructuredText

  • 优点

    语法特性丰富，适合小，中，大型文档的系统开发

  • 缺点

    实现复杂高级的功能时上手的门槛也比较高

两种写文档的方式的具体细节可以到网上查阅相应的语法即可，在此不再赘述。总之，熟练使用这两种语言中的一种，可以使得写文档者以后就更多的关注于文档的内容的产生，而不是格式的调整了。

个人比较偏爱 restructuredText 来写ReadMe，主要原因如下：

• 天然支持生成目录及文章锚点
• 支持文章内交叉引用
• 有比较友好的表格语法
• 很多很多的其它很强的语法特性
• 自己在开发大型文档的时候都使用rst，所以就不用和markdown混用了

一个比较典型的ReadMe的内容应包括但不限于：

• 目录
• 项目介绍
• 安装方法
• 使用Demo
• 发布路线图

具体可以参考示例项目的 ReadMe 的写法。

4.1   commits

用户在本地的工作空间里面为项目添加新功能或者修改bug，不断的提交，更新项目的版本，这样促使项目不断的向前推进迭代。这些提交过程(commits)日积月累，就由git形成了稳定的提交线路图。

原则上，用户应该尽量勤快提交，因为这样可以小步快速迭代，而且即使出了问题也可以在回滚的版本精确度也会更高：git可以将项目版本恢复到任何的纳入版本管理的提交节点处。

4.2   branches

分支是git最重要的特性，这是项目要进行比较大的修改，而且要保证原分支特性能够得到妥善管理时的一个重要功能。使用分支功能，可以很方便的看到产品的各种重要衍生阶段和归并阶段，同时也极大的方便了开发者在这几个分支之间进行切换。

针对此特性，还诞生了不少工作流，比较典型的分支工作流如下图：

4.3   releases

在git中除了 分支branch 的概念外，还有 标签tag 的概念。

通过tag的相应命令，为某个里程碑的可发布版本打上标签，推送到 Github 上之后的体现形式就是在 relases 选项卡里面提供了tag的各种线路图，直接打包成压缩包文件供用户统一下载。

当然此处也可以针对每个发布的节点标签写上发布日志，但是一般不建议这样，因为这样这些信息就存储在 Github 信息系统里面了，而不是存储在git项目里面了。一般建议将这些信息写在ReadMe里面，这样可以维持项目的完整性，同时也没有丢失掉项目线路图的具体迭代描述。