git使用及提交规范

Git 版本控制

Git中大部分操作都是针对本地文件和本地数据库，只有在我们平时执行类似克隆(clone)、pull、push等命令时才与远程服务器交互。这样对于开发维护代码库就很安全，因为一旦远程服务器代码丢失仍然可以将本地代码上传到服务器；也会给开发者带来诸多方便，因为将远程代码取到本地后可以随意的修改，一旦修改混乱之后仍然可以恢复到以前版本，即使本地代码被误删除仍然可以重新从服务器取回代码。

下面将针对一些常用使用命令和技巧进行介绍：

一、git提交规范

在commit是,如果有对应PR，请在第一行写上PR号，然后再描述信息（另起行），并把涉及到改动的文件名附上.

具体操作如下(不用git commit -m 填写说明):

1、如果提交全部文件(请先git status确认是否要提交所有改动)

1.1 git commit -a

1.2 在打开的编辑器中(默认为VIM) 第一行填写PR号(顶格写，多个

PR用逗号隔开，要写全)，然后再写说明。

1.3 把涉及修改文件路径前的# 去掉,就会提交，不用手工输入文件路径。

1.4 然后ESC 输入:wq退出VIM.

2、如果提交部分文件

2.1 分别git add 要提交的所有文件。

2.2 git commit。

2.3 以后步骤同上。

二、第一次初始配置

1、第一次取出代码到本地需要克隆代码（从服务器取代码到本地），一般如果新建一个本地代码库都需要重新克隆一次代码。

命令：git clone git://服务器代码库地址

2、第一次使用git环境一般应该配置你的用户信息，这样会方便别人与自己查看git提交代码记录。

命令：$ git config --global zhangsan

$ git config --global user.email *****************.cn

这里使用的—global，以后的所有项目都默认使用这个配置，这时写入的是用户主目录的git配置文件（跟曲以鹏在邮件里边说的那个“.gitconfig”文件应该是一回事），如果想改变其中一个项目的配置可以去掉—global重新配置如：

命令：$ git config lisi

查看这些配置信息，如：

命令：$ git config --list

3、修改编辑器，一般我们在git commit（提交）后，需要添加PR号或者添加注释信息，对于编辑可以选用自己习惯的编辑器如：vi

命令：$ git config --global core.editor vi

三、提交代码（这部分只是针对本地代码库，所有操作都没有涉及服务器）

1、提交代码过程大家都非常熟悉，平时常用几种命令，如：

$ git add file –> $ git commit 或者全部提交：$ git commit –a

当中可能经常使用如$ git status 查询状态、$ git diff 比较不同。

下面总结了一些以上过程中比较、撤销等好用命令。

2、本地操作代码库状态

本地操作后，本地代码库会有三种状态：修改、暂存、提交。

修改暂存提交

Git add Git commit

Git add 后就从修改变为暂存，git commit 后就从暂存变为提交。

1）、各个状态比较命令如：

修改与暂存比较不同：$ git diff <文件路径>

暂存与上次提交比较不同：$ git diff --cached <文件路径>

2）、将文件从暂存移除变为修改状态，一般git add后发现添加文件多了，可以使用命令如：

$ git reset HEAD

3）、修改提交文件，代码提交以后会产生一个哈希值类似(a124b9da6552252987aa493b52f8696cd6d3b003)一字符串，以后可以根据哈希值回到相应版本。

对于刚刚提交的代码很容易忘记写注释（PR）或者漏提交了部分文件，这时可以使用命令修改上次的提交：$ git commit --amend

如果添加注释可以直接执行命令，填写注释保存。

如果添加文件先执行$ git add 后执行$ git commit –amend

3、查看以前提交情况

1）、查看某人提交日志

命令：$ git log --author=zengyun

2）、搜索提交日志（根据第一行的PR号）

命令：$ git log --grep=PR000667740

这里边的PR号一定在第一行写，如果多个PR号请用‘，’隔开。具体请参考git 提交规范。

3）、查看某文件夹log

命令：$ git log framework/base/core/java/android/

4）、查看每次提交信息

命令：$ git log -p -2

-2表示最近两次提交。

5）、查看某次提交的详细信息

命令：$ git show 5ba47ce9ceb4c5db86563c03c6833ee47bd22a53

6）、如果精确查找显示可以将上面1）、2）、3）、4）组合使用。

四、远程服务器取、推代码。（与服务器交互）

前面提过克隆命令：git clone git://服务器，它实现过程实际上是创建本地分支master，并且去服务器代码到本地。

1、取代码从服务器命令：$ git pull

2、推代码到服务器命令：$ git push

在主分支下，不用指定分支名称，系统会默认为pull主分支。

五、切换到分支下工作

目前各种定制越来越多，作为使用者如何直接进入分支，开展我们的开发工作。下面以印度分支为例进行说明：

1、克隆代码，

命令：git clone git://192.168.1.231/home/android/workspace/App7627_5330

注：(如果本地有代码则没有此步)

2、确定当前分支所在，

命令：git branch

例如：

Inida_MMX

* master

表示当前所在分支是主分支master