Git团队协做使用规范

时间  2019-12-07 标签 git 团队 使用 规范

转载自：http://blog.csdn.net/self001/article/details/7333096php

Git 使用规范

特别提醒：git

  • 使用Git过程当中，必须经过建立分支进行开发，坚定禁止在主干分支上直接开发。review的同事有责任检查其余同事是否遵循分支规范。
  • 在Git中，默认是不会提交空目录的，若是想提交某个空目录到版本库中，须要在该目录下新建一个 .gitignore 的空白文件，就能够提交了
  • 【代码回溯注意】把外部文件归入到本身的 Git 分支来的时候必定要记得是先比对，确认全部修改都是本身修改的，而后再归入。否则，容易出现代码回溯
  • 【代码回溯注意】多人协做时，不要各自在本身的 Git 分支开发，而后发文件合并。正确的方法应该是开一个远程分支，而后一块儿在远程分支里协做。否则，容易出现代码回溯（即别人的代码被覆盖的状况）
  • 【代码回溯注意】每一个人提交代码是必定要 git diff 看提交的东西是否是都是本身修改的。若是有不是本身修改的内容，极可能就是代码回溯
  • 【代码回溯注意】review 代码的时候若是看到有被删除掉的代码，必定要确实是不是写代码的同事本身删除的。若是不是，极可能就是代码回溯

格式：[分支名称]+message
例如：[www2011072501]前台商品列表按价格排序需求实现。
好比有一个客户留言功能，被咱们拆成了不少子块，那么提交注释以下：github

git commit -m “[manage2011072501]完成客户留言的添加、修改功能”
git commit -m “[manage2011072501]完成客户留言的回复功能” git commit -m “[manage2011072501]把旧客户留言的功能删除”web

分支合并及上线

步骤 Git 操做
- 克隆代码 git clone 远程代码
- 建立分支 git checkout -b branch_name
- 在分支中开发 无
- review代码 无
- 第一轮测试 无
- 添加代码到分支的暂存区 git add somefile
- 提交代码到分支 git commit -m “本次提交的注释”
- 切换到主版本 git checkout master
- 获取远程最新代码 git pull origin master
- 合并某分支到master分支 git merge branch_name
- 解决合并时产生的冲突 请参考分支合并时冲突的解决 无
- 第二轮测试 无
- 准备上线文档 无
- 获取远程最新代码 git pull origin master
- 推送master分支 git push origin master
- 通知上线 无
- 没有问题了删除本地分支 git branch -d branch_namesql

三种状态

对于任何一个文件，在 Git 内都只有三种状态数据库

中文 英文 含义
已提交 committed 已提交表示该文件已经被安全地保存在本地数据库中了
已修改 modified 已修改表示修改了某个文件，但尚未提交保存
已暂存 staged 已暂存表示把已修改的文件放在下次提交时要保存的清单中
目录 用法
git 目录 它是 Git 用来保存元数据和对象数据库的地方。该目录很是重要，每次克隆镜像仓库的时候，实际拷贝的就是这个目录里面的数据。
工做目录 从项目中取出某个版本的全部文件和目录，用以开始后续工做的叫作工做目录。这些文件实际上都是从 git 目录中的压缩对象数据库中提取出来的，接下来就能够在工做目录中对这些文件进行编辑
暂存区域 所谓的暂存区域只不过是个简单的文件，通常都放在 git 目录中。有时候人们会把这个文件叫作索引文件，不过标准说法仍是叫暂存区域。

基本的 Git 工做流程

一、在工做目录中修改某些文件。
二、对这些修改了的文件做快照，并保存到暂存区域。
三、提交更新，将保存在暂存区域的文件快照转储到 git 目录中。vim

安装 Git

如下命令安装的为git 1.7.1
sudo apt-get install -y git-core安全

配置 Git

如下命令为配置 Git 相关信息，如下两项必需要配置，会出如今每次提交的信息里。bash

git config --global user.name  "caowlong" #规定为姓名全拼
git config --global user.email "caowlong163@163.com" #规定为公司邮箱
git config --global merge.tool "meld"
git config --global color.ui   true # 使用git默认的配色方案，推荐
git config --global --list # 查看配置信息
git config --global user.name # 查看 user.name 的配置信息 
让 Git 用 meld 比较文件差别
gedit ~/git-meld.sh
#输入下面两行内容保存并退出

#!/bin/sh
meld $2 $5
#执行
chmod +x ~/git-meld.sh
git config --global diff.external ~/git-meld.sh
#如下为使用示例
git diff readme.txt
git diff --cached readme.txt

获取帮助

格式 git help
示例服务器

git help commit # 按 q 退出帮助

取得项目的 Git 仓库

有两种取得 Git 项目仓库的方法
在现存的目录下，经过导入全部文件来建立新的 Git 仓库从已有的 Git 仓库克隆出一个新的镜像仓库来
1、从当前目录初始化
要对现有的某个项目开始用 Git 管理，只需到此项目所在的目录，执行
cd 某个目录
git init
初始化后，在当前目录下会出现一个名为 .git 的目录，全部 Git 须要的数据和资源都存放在这个目录中。
不过目前，仅仅是按照既有的结构框架初始化好了里边全部的文件和目录，但咱们尚未开始跟踪管理项目中的任何一个文件
命令 含义
git add *.php 把全部的php文件放入暂存区
git add readme.txt 把名为readme.txt的文件放入暂存区
git add dir/ 把名为dir的目录里的全部文件放入暂存区
git add * 把当前目录的全部文件都放入暂存区
git rm –cached dir/ -r 把名为dir的目录里的全部文件取消暂存
git rm –cached readme.txt 把名为readme.txt的文件取消暂存
git commit -m ‘初始化版本库’ 提交代码到本地仓库 “初始化版本库”为本次提交的注释信息
这样咱们就建立了一个新的 Git 仓库

2、从现有仓库克隆
这个适合咱们在公司环境下用，咱们能够先把某个项目的 Git 仓库复制一份出来，这就须要用到 git clone 命令。若是你熟悉其余的 VCS 好比 Subversion，你可能已经注意到这里使用的是 clone 而不是 checkout。
Git 收取的是项目历史的全部数据（每个文件的每个版本），服务器上有的数据克隆以后本地也都有了。实际上，即使服务器的磁盘发生故障，用任何一个克隆出来的客户端均可以重建服务器上的仓库，回到当初克隆时的状态。
命令格式为： git clone [url] [projectName] 以下两行均为克隆 Ruby 语言的 Git 代码仓库 Grit。
git clone git://github.com/schacon/grit.git # projectName 省略时以 grit 为默认目录
这会在当前目录下建立一个名为 “grit” 的目录，其中内含一个 .git 的目录，并从同步后的仓库中拉出全部的数据，取出最新版本的文件拷贝。若是进入这个新建的 grit 目录，你会看到项目中的全部文件已经在里边了，准备好后续的开发和使用。若是但愿在克隆的时候，本身定义要新建的项目目录名称，能够在上面的命令最后指定：
git clone git://github.com/schacon/grit.git mygrit # 以 mygrit 为默认目录
cd mygrit
git gc
记录每次更新到仓库

工做目录下面的全部文件的这两种状态
已跟踪 已跟踪的文件是指原本就被归入版本控制管理的文件，在上次快照中有它们的记录，工做一段时间后，它们的状态多是未更新，已修改或者已放入暂存区。初次克隆某个仓库时，工做目录中的全部文件都属于已跟踪文件，且状态为未修改。 未跟踪 而全部其余文件都属于未跟踪文件。它们既没有上次更新时的快照，也不在当前的暂存区域。好比：一个全新的文件。
在编辑过某些文件以后，Git 将这些文件标为已修改。咱们逐步把这些修改过的文件放到暂存区域，而后等最后一次性提交暂存区域的全部文件更新，如此重复。以下图

检查当前文件状态
如今咱们能够在命令行下回到刚才的git目录。要肯定哪些文件当前处于什么状态，能够用 git status 命令
git status 

#On branch master

nothing to commit (working directory clean)
新建一个test.txt的文件，再用git status來看
vi test.txt # 按i输入内容而后 按ESC 按shift+z+z保存并退出
git status 

# On branch master 
# Untracked files: 
#       (use "git add <file>..." to include in what will be committed) 
# 
#             test.txt

nothing added to commit but untracked files present (use “git add” to track)
跟踪新文件
使用命令 git add 开始跟踪一个新文件，如跟踪刚才创建的test.txt文件
git add test.txt
git status

# On branch master
# Changes to be committed:
#   (use "git reset HEAD <file>..." to unstage)
#
#    new file:   test.txt
#

只要在 “Changes to be committed” 这行下面的，就说明是已暂存状态。
暂存已修改文件
咱们修改一下刚才grit目录下已存在的文件，如benchmarks.txt

vim benchmarks.txt # 按i输入内容而后 按ESC 按shift+z+z保存并退出
git status

# On branch master
    # Changes to be committed:
    #   (use "git reset HEAD <file>..." to unstage)
    #
    #    new file:   test.txt
    #
    # Changed but not updated:
    #   (use "git add <file>..." to update what will be committed)
    #   (use "git checkout -- <file>..." to discard changes in working directory)
    #
    #    modified:   benchmarks.txt
    #

文件 benchmarks.txt 出如今 “Changed but not updated” 这行下面，说明已跟踪文件的内容发生了变化，但尚未放到暂存区。要暂存此次更新，须要运行 git add 命令，这是个多功能命令，根据目标文件的状态不一样，此命令的效果也不一样

能够用它开始跟踪新文件
把已跟踪的文件放到暂存区
合并时把有冲突的文件标记为已解决状态

git add benchmarks.txt
git status

# On branch master
    # Changes to be committed:
    #   (use "git reset HEAD <file>..." to unstage)
    #
    #    modified:   benchmarks.txt
    #    new file:   test.txt
    #

如今两个文件都已暂存，下次提交时就会一并记录到仓库。
假设此时，你想要在 benchmarks.txt 里再加一行，从新编辑存盘后，准备好提交。不过稍等一下，再运行 git status 看看：
vim benchmarks.txt
git status

On branch master
Changes to be committed:
(use “git reset HEAD …” to unstage)
modified: benchmarks.txt
new file: test.txt
Changed but not updated:
(use “git add …” to update what will be committed)
(use “git checkout – …” to discard changes in working directory)
modified: benchmarks.txt

如今咱们发现 benchmarks.txt 文件出现了两次！一次算未暂存，一次算已暂存，这怎么可能呢？好吧，实际上 Git 只不过暂存了你运行 git add 命令时的版本，若是如今提交，那么提交的是添加注释前的版本，而非当前工做目录中的版本。因此，运行了 git add 以后又做了修订的文件，须要从新运行 git add 把最新版本从新暂存起来：
git add benchmarks.txt
git status

On branch master
Changes to be committed:
(use “git reset HEAD …” to unstage)
modified: benchmarks.txt
new file: test.txt

  • 查看已暂存和未暂存的更新
    git diff –staged # 已经暂存起来的文件和上次提交时的快照之间的差别 也能够用 git diff –cached
    git diff # 直接使用此命令是 工做目录中当前文件和暂存区域快照之间的差别

  • 提交更新
    如今的暂存区域已经准备稳当能够提交了。在此以前，请必定要确认还有什么修改过的或新建的文件尚未 git add 过，不然提交的时候不会记录这些还没暂存起来的变化。因此，每次准备提交前，先用 git status 看下，是否是都已暂存起来了，而后再运行提交命令 git commit：
    git status
    git commit -m “提交备注” # 能够直接提交
    这样咱们就完成了一次git提交

  • 跳过使用暂存区域
    不推荐 尽管使用暂存区域的方式能够精心准备要提交的细节，但有时候这么作略显繁琐。Git 提供了一个跳过使用暂存区域的方式，只要在提交的时候，给 git commit 加上 -a 选项，Git 就会自动把全部已经跟踪过的文件暂存起来一并提交，从而跳过 git add 步骤：
    git commit -a -m “强制提交备注”

移除文件

要从 Git 中移除某个文件，就必需要从已跟踪文件清单中移除（确切地说，是从暂存区域移除），而后提交。能够用 git rm 命令完成此项工做，并连带从工做目录中删除指定的文件，这样之后就不会出如今未跟踪文件清单中了。

git rm somefile #
若是删除以前修改过而且已经放到暂存区域的话，则必需要用强制删除选项 -f
git rm -f somefile
咱们想把文件从 Git 仓库中删除（亦即从暂存区域移除），但仍然但愿保留在当前工做目录中。换句话说，仅是从跟踪清单中删除。
git rm –cached readme.txt
批量移除
git rm log/*.log

移动文件

要在 Git 中对文件更名，能够这么作：
git mv file_from file_to
至关于执行如下的3个命令

mv file_from file_to
git rm file_from
git add file_to

示例以下

git mv test.txt testtest.txt git status

On branch master
Changes to be committed:
(use “git reset HEAD …” to unstage)
new file: testtest.txt

查看提交历史

在提交了若干更新以后，又或者克隆了某个项目，想回顾下提交历史，可使用 git log 命令。

git clone git://github.com/schacon/simplegit-progit.git
cd simplegit-progit/

而后在此项目中运行 git log，应该会看到下面的git logcommit ca82a6dff817ec66f44342007202690a93763949 Author: Scott Chacon

schacon@gmail.com Date: Mon Mar 17 21:52:11 2008 -0700

changed the verison number

commit 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7 Author: Scott Chacon
schacon@gmail.com Date: Sat Mar 15 16:40:33 2008 -0700

removed unnecessary test code

commit a11bef06a3f659402fe7563abf99ad00de2209e6 Author: Scott Chacon
schacon@gmail.com Date: Sat Mar 15 10:31:28 2008 -0700

first commit

更多参数说明

参数 说明
-p 按补丁格式显示每一个更新之间的差别
–stat 显示每次更新的文件修改统计信息
–shortstat 只显示 –stat 中最后的行数修改添加移除统计
–name-only 仅在提交信息后显示已修改的文件清单
–name-status 显示新增、修改、删除的文件清单
–abbrev-commit 仅显示 SHA-1 的前几个字符，而非全部的 40 个字符
–relative-date 使用较短的相对时间显示（好比，“2 weeks ago”）
–grap 显示 ASCII 图形表示的分支合并历史
–pretty 使用其余格式显示历史提交信息。可用的选项包括 oneline，short，full，fuller 和 format（后跟指定格式）
-n 仅显示最近的 n 条提交
–since, –after 仅显示指定时间以后的提交
–until, –before 仅显示指定时间以前的提交
–author 仅显示指定做者相关的提交
–committer 仅显示指定提交者相关的提交 
git log --pretty=oneline
git log --pretty=format:"%h - %an, %ar : %s"
#若是要查看 Git 仓库中，2008 年 10 月期间，Junio Hamano 提交的但未合并的测试脚本（位于项目的 t/ 目录下的文件）
git log --pretty="%h:%s" --author=gitster --since="2008-10-01" \
   --before="2008-11-01" --no-merges -- t/
选项 说明
%H 提交对象（commit）的完整哈希字串
%h 提交对象的简短哈希字串
%T 树对象（tree）的完整哈希字串
%t 树对象的简短哈希字串
%P 父对象（parent）的完整哈希字串
%p 父对象的简短哈希字串
%an 做者（author）的名字
%ae 做者的电子邮件地址
%ad 做者修订日期（能够用 -date= 选项定制格式）
%ar 做者修订日期，按多久之前的方式显示
%cn 提交者(committer)的名字
%ce 提交者的电子邮件地址
%cd 提交日期
%cr 提交日期，按多久之前的方式显示
%s 提交说明

撤消操做

修改最后一次提交
有时候咱们提交完了才发现漏掉了几个文件没有加，或者提交信息写错了。想要撤消刚才的提交操做，可使用 –amend 选项从新提交：

git commit -m 'first' git add test.txt git commit --amend -m 'first too'

取消已经暂存的文件

git reset HEAD filename

取消对文件的修改
这里指未git add到的暂存区的文件
在用这条命令前，请务必肯定真的再也不须要保留刚才的修改。

git checkout -- filename

远程仓库的使用

同他人协做开发某个项目时，须要管理这些远程仓库，以便推送或拉取数据，分享各自的工做进展。管理远程仓库的工做，包括添加远程库，移除废弃的远程库，管理各式远程库分支，定义是否跟踪这些分支，等等。
查看当前的远程库
使用git remote 查看当前配置有哪些远程仓库，至少能够看到一个名为 origin 的远程库，Git 默认使用这个名字来标识你所克隆的原始仓库：

git clone git://github.com/schacon/ticgit.git
cd ticgit
git remote # 列出每一个远程库的简短名字
  origin
git remote -v # 显示对应的克隆地址
  origin    git://github.com/schacon/ticgit.git (fetch)
  origin    git://github.com/schacon/ticgit.git (push)

添加远程仓库

要添加一个新的远程仓库，能够指定一个简单的名字，以便未来引用格式：git remote add [shortname] [url]：

cd ticgit/
git remote -v
  origin    git://github.com/schacon/ticgit.git (fetch)
  origin    git://github.com/schacon/ticgit.git (pus
git remote add pb git://github.com/paulboone/ticgit.git
git remote -v
  origin    git://github.com/schacon/ticgit.git (fetch)
  origin    git://github.com/schacon/ticgit.git (push)
  pb    git://github.com/paulboone/ticgit.git (fetch)
  pb    git://github.com/paulboone/ticgit.git (push)
如今能够用字串 pb 指代对应的仓库地址了
git fetch pb
  remote: Counting objects: 58, done.
  remote: Compressing objects: 100% (24/24), done.
  remote: Total 44 (delta 23), reused 38 (delta 17)
  Unpacking objects: 100% (44/44), done.
  From git://github.com/paulboone/ticgit
   * [new branch]      master     -> pb/master
   * [new branch]      ticgit     -> pb/ticgit

从远程仓库抓取数据

命令 git pull [remote-name]
此命令会到远程仓库中拉取全部你本地仓库中尚未的数据。运行完成后，你就能够在本地访问该远程仓库中的全部分支，将其中某个分支合并到本地，或者只是取出某个分支
若是是克隆了一个仓库，此命令会自动将远程仓库归于 origin 名下。因此，git pull origin 会抓取从你上次克隆以来别人上传到此远程仓库中的全部更新（或是上次 pull 以来别人提交的更新）。有一点很重要，须要记住，pull 命令只是将远端的数据拉到本地仓库，并不自动合并到当前工做分支，只有当你确实准备好了，才能手工合并。

推送数据到远程仓库

项目进行到一个阶段，要同别人分享目前的成果，能够将本地仓库中的数据推送到远程仓库。实现这个任务的命令很简单： git push [remote-name] [branch-name]。若是要把本地的 master 分支推送到 origin 服务器上（再次说明下，克隆操做会自动使用默认的 master 和 origin 名字），能够运行下面的命令：
git push origin master
只有在所克隆的服务器上有写权限，或者同一时刻没有其余人在推数据，这条命令才会如期完成任务。若是在你推数据前，已经有其余人推送了若干更新，那你的推送操做就会被驳回。你必须先把他们的更新抓取到本地，并到本身的项目中，而后才能够再次推送。

远程仓库的删除和重命名

在新版 Git 中能够用 git remote rename 命令修改某个远程仓库的简短名称，好比想把 pb 改为 paul，能够这么运行：

git remote rename pb paul
git remote
  origin
  paul

移除远程仓库

git remote rm paul
git remote
  origin
联系我们 沪ICP备13005482号-10