多种多样的工作流使得在项目中实施Git时变得难以选择。这份教程提供了一个出发点,调查企业团队最常见的Git工作流。

阅读的时候,请记住工作流应该是一种规范而不是金科玉律。我们希望向你展示所有工作流,让你融会贯通,因地制宜。

这份教程讨论了下面四种工作流:

中心化的工作流

过渡到分布式分版本控制系统看起来是个令人恐惧的任务,但你不必为了利用Git的优点而改变你现有的工作流。你的团队仍然可以用以前SVN的方式开发项目。

然而,使用Git来驱动你的开发工作流显示出了一些SVN没有的优点。首先,它让每个开发者都有了自己 本地 的完整项目副本。隔离的环境使得每个开发者的工作独立于项目的其它修改——他们可以在自己的本地仓库中添加提交,完全无视上游的开发,直到需要的时候。

第二,它让你接触到了Git鲁棒的分支和合并模型。和SVN不同,Git分支被设计为一种故障安全的机制,用来在仓库之间整合代码和共享更改。

如何工作

和Subversion一样,中心化的工作流将中央仓库作为项目中所有修改的唯一入口。和trunk不同,默认的开发分支叫做master,所有更改都被提交到这个分支。这种工作流不需要master之外的其它分支。

开发者将中央仓库克隆到本地后开始工作。在他们的本地项目副本中,他们可以像SVN一样修改文件和提交更改;不过,这些新的提交被保存在 本地 ——它们和中央仓库完全隔离。这使得开发者可以将和上游的同步推迟到他们方便的时候。

为了向官方项目发布修改,开发者将他们的本地master分支“推送”到中央仓库。这一步等同于svn commit,除了Git添加的是所有不在中央master分支上的本地提交。

管理冲突

中央仓库代表官方项目,因此它的提交历史应该被视作神圣不可更改的。如果开发者的本地提交和中央仓库分叉了,Git会拒绝将他们的修改推送上去,因为这会覆盖官方提交。

在开发者发布他们的功能之前,他们需要fetch更新的中央提交,在它们之上rebase自己的更改。这就像是:“我想要在其他人的工作进展之上添加我的修改。”它会产生完美的线性历史,就像和传统的SVN工作流一样。

如果本地修改和上游提交冲突时,Git会暂停rebase流程,给你机会手动解决这些冲突。Git很赞的一点是,它将git statusgit add命令同时用来生成提交和解决合并冲突。这使得开发者能够轻而易举地管理他们的合并。另外,如果他们改错了什么,Git让他们轻易地退出rebase过程,然后重试(或者找人帮忙)。

例子

让我们一步步观察一个普通的小团队是如何使用这种工作流协作的。我们有两位开发者,John和Mary,分别在开发两个功能,他们通过中心化的仓库共享代码。

一人初始化了中央仓库

首先,需要有人在服务器上创建中央仓库。如果这是一个新项目,你可以初始化一个空的仓库。不然,你需要导入一个已经存在的Git或SVN项目。

中央仓库应该永远是裸仓库(没有工作目录),可以这样创建:

ssh user@host git init --bare /path/to/repo.git

但确保你使用的SSH用户名user、服务器host的域名或IP地址、储存仓库的地址/path/to/repo.git是有效的。注意.git约定俗成地出现在仓库名的后面,表明这是一个裸仓库。

所有人将仓库克隆到本地

接下来,每个开发者在本地创建一份完整项目的副本。使用git clone命令:

git clone ssh://user@host/path/to/repo.git

当你克隆仓库时,Git自动添加了一个名为origin的远程连接,指向“父”仓库,以便你以后和这个仓库交换数据。

John在开发他的功能

在他的本地仓库中,John可以用标准的Git提交流程开发功能:编辑、缓存、提交。如果你对缓存区还不熟悉,你也可以不用记录工作目录中每次的变化。于是你创建了一个高度集中的提交,即使你已经在本地做了很多修改。

  1.  
    git status # 查看仓库状态
  2.  
    git add <some-file> # 缓存一个文件
  3.  
    git commit # 提交一个文件</some-file>

记住,这些命令创建的是本地提交,John可以周而复始地重复这个过程,而不用考虑中央仓库。对于庞大的功能,需要切成更简单、原子化的片段时,这个特性就很有用。

Mary在开发她的功能

同时,Mary在她自己的本地仓库用相同的编辑/缓存/提交流程开发她的功能。和John一样,她不需要关心中央仓库的进展,她也 完全 不关心John在他自己仓库中做的事,因为所有本地仓库都是私有的。

John发布了他的功能

一旦John完成了他的功能,他应该将本地提交发布到中央仓库,这样其他项目成员就可以访问了。他可以使用git push命令,就像:

git push origin master

记住,origin是John克隆中央仓库时指向它的远程连接。master参数告诉Git试着将originmaster分支变得和他本地的master分支一样。中央仓库在John克隆之后还没有进展,因此这个推送如他所愿,没有产生冲突。

Mary试图发布她的功能

John已经成功地将他的更改发布到了中央仓库上,看看当Mary试着将她的功能推送到上面时会发生什么。她可以使用同一个推送命令:

git push origin master

但是,她的本地历史和中央仓库已经分叉了,Git会拒绝这个请求,并显示一段冗长的错误信息:

  1.  
    error: failed to push some refs to '/path/to/repo.git'
  2.  
    hint: Updates were rejected because the tip of your current branch is behind
  3.  
    hint: its remote counterpart. Merge the remote changes (e.g. 'git pull')
  4.  
    hint: before pushing again.
  5.  
    hint: See the 'Note about fast-forwards' in 'git push --help' for details.

Git防止Mary覆盖官方的修改。她需要将John的更新拉取到她的仓库,和她的本地修改整合后,然后重试。

Mary在John的提交之上rebase

Mary可以使用git pull来将上游修改并入她的仓库。这个命令和svn update很像——它拉取整个上游提交历史到Mary的本地仓库,并和她的本地提交一起整合:

git pull --rebase origin master

--rebase选项告诉Git,在同步了中央仓库的修改之后,将Mary所有的提交移到master分支的顶端,如下图所示:

如果你忽略这个选项拉取同样会成功,只不过你每次和中央仓库同步时都会多出一个“合并提交”。在这种工作流中,rebase和生成一个合并提交相比,总是一个更好的选择。

Mary解决了合并冲突

Rebase的工作是将每个本地提交一个个转移到更新后的master分支。也就是说,你可以一个个提交分别解决合并冲突,而不是在一个庞大的合并提交中解决。它会让你的每个提交保持专注,并获得一个干净的项目历史。另一方面,你更容易发现bug是在哪引入的,如果有必要的话,用最小的代价回滚这些修改。

如果Mary和John开发的功能没有关联,rebase的过程不太可能出现冲突。但如果出现冲突时,Git在当前提交会暂停rebase,输出下面的信息,和一些相关的指令:

CONFLICT (content): Merge conflict in <some-file>

Git的优点在于 每个人 都能解决他们自己的合并冲突。在这个例子中,Mary只需运行一下git status就可以发现问题是什么。冲突的文件会出现在未合并路径中:

  1.  
    # Unmerged paths:
  2.  
    # (use "git reset HEAD <some-file>..." to unstage)
  3.  
    # (use "git add/rm <some-file>..." as appropriate to mark resolution)
  4.  
    #
  5.  
    # both modified: <some-file>

接下来,修改这些文件。如果她对结果满意了,和往常一样缓存这些文件,然后让git rebase完成接下来的工作:

  1.  
    git add <some-file>
  2.  
    git rebase --continue

就是这样。Git会继续检查下个提交,对冲突的提交重复这个流程。

如果你这时候发现不知道自己做了什么,不要惊慌。只要运行下面的命令,你就会回到开始之前的状态:

git rebase --abort

Mary成功发布了她的分支

在她和中央仓库同步之后,Mary可以成功地发布她的修改:

git push origin master

接下来该怎么做

正如你所见,使用一丢丢Git命令来复制一套传统的Subversion开发环境也是可行的。这对于从SVN转变而来的团队来说很棒,但这样没有利用到Git分布式的本质。

如果你的团队已经习惯了中心化的工作流,但希望提高协作效率,那么探索Feature分支工作流的好处是完全值当的。每个功能在专门的独立分支上进行,在代码并入官方项目之前就可以启动围绕新修改的深度讨论。

Feature分支的工作流

一旦你掌握了中心化工作流的使用姿势,在你的开发流程中添加功能分支是一个简单的方式,来促进协作和开发者之间的交流。这种封装使得多个开发者专注自己的功能而不会打扰主代码库。它还保证master分支永远不会包含损坏的代码,给持续集成环境带来了是很大的好处。

封装功能的开发使得pull request的使用成为可能,用来启动围绕一个分支的讨论。它给了其他开发者在功能并入主项目之前参与决策的机会。或者,如果你开发功能时卡在一半,你可以发起一个pull request,向同事寻求建议。重点是,pull request使得你的团队在评论其他人的工作时变得非常简单。

如何工作

Feature分支工作流同样使用中央仓库,master同样代表官方的项目历史。但是,与其直接提交在本地的master分支,开发者每次进行新的工作时创建一个新的分支。Feature分支应该包含描述性的名称,比如animated-menu-items(菜单项动画)或issue-#1061。每个分支都应该有一个清晰、高度集中的目的。

Git在技术上无法区别master和功能分支,所以开发者可以在feature分支上编辑、缓存、提交,就和中心化工作流中一样。

此外,feature分支可以(也应该)被推送到中央仓库。这使得你和其他开发者共享这个功能,而又不改变官方代码。既然master只是一个“特殊”的分支,在中央仓库中储存多个feature分支不会引出什么问题。当然了,这也是备份每个开发者本地提交的好办法。

Pull Request

除了隔离功能开发之外,分支使得通过pull request讨论修改成为可能。一旦有人完成了一个功能,他们不会立即将它并入master。他们将feature分支推送到中央服务器上,发布一个pull request,请求将他们的修改并入master。这给了其他开发者在修改并入主代码库之前审查的机会。

代码审查是pull request的主要好处,但他们事实上被设计为成为讨论代码的一般场所。你可以把pull request看作是专注某个分支的讨论版。也就是说他们可以用于开发流程之前。比如,一个开发者在某个功能上需要帮助,他只需发起一个pull request。感兴趣的小伙伴会自动收到通知,看到相关提交中的问题。

一旦pull request被接受了,发布功能的行为和中心化的工作流是一样的。首先,确定你本地的master和上游的master已经同步。然后,将feature分支并入master,将更新的master推送回中央仓库。

例子

下面这个��演示了代码审查使用到的pull request,但记住pull request有多种用途。

Mary开始了一个新功能

在她开始开发一个功能之前,Mary需要一个独立的分支。她可以用下面的命令创建新分支

git checkout -b marys-feature master

一个基于master、名为marys-feature的分支将会被checkout,-b标记告诉Git在分支不存在时创建它。在这个分支上,Mary和往常一样编辑、缓存、提交更改,用足够多的提交来构建这个功能:

  1.  
    git status
  2.  
    git add <some-file>
  3.  
    git commit

Mary去吃饭了

Mary在早上给她的功能添加了一些提交。在她去吃午饭前,将她的分支推送到中央仓库是个不错的想法。这是一种方便的备份,但如果Mary和其他开发者一起协作,他们也可以看到她的初始提交了。

git push -u origin marys-feature

这个命令将marys-feature推送到中央仓库(origin),-u标记将它添加为远程跟踪的分支。在设置完跟踪的分支之后,Mary调用不带任何参数的git push来推送她的功能。

Mary完成了她的工作

当Mary吃完午饭回来,她完成了她的功能。在并入master之前,她需要发布一个pull request,让其他的团队成员知道她所做的工作。但首先,她应该保证中央仓库包含了她最新的提交:

git push

然后,她在她的Git界面上发起了一个pull request,请求将marys-feature合并进master,团队成员会收到自动的通知。Pull request的好处是,评论显示在相关的提交正下方,方便讨论特定的修改。

Bill收到了pull request

Bill收到了pull request,并且查看了marys-feature。他决定在并入官方项目之前做一些小修改,通过pull request和Mary进行了沟通。

Mary作了修改

为了做这些更改,Mary重复了之前创建功能时相同的流程,她编辑、缓存、提交、将更新推送到中央仓库。她所有的活动显示在pull request中,Bill可以一直评论。

如果Bill想要的话,也可以将marys-featurepull到他自己的本地仓库,继续工作。后续的任何提交都会显示在pull request上。

Mary发布了她的功能

一旦Bill准备接受这个pull request,某个人(Bill或者Mary都可)需要将功能并入稳定的项目:

  1.  
    git checkout master
  2.  
    git pull
  3.  
    git pull origin marys-feature
  4.  
    git push

首先,不管是谁在执行合并,都要保证他们的master分支是最新的。然后,运行git pull origin marys-feature合并中央仓库的marys-feature副本。你也可以使用简单的git merge marys-feature,但之前的命令保证你拉取下来的一定是功能分支最新的版本。最后,更新的master需要被推送回origin

这个过程导致了一个合并提交。一些开发者喜欢它,因为它是功能和其余代码合并的标志。但,如果你希望得到线性的历史,你可以在执行merge之前将功能rebase到master分支的顶端,产生一个快速向前的合并。

一些界面会自动化接受pull request的流程,只需点击一下“Merge Pull Request”。如果你的没有的话,它至少在合并之后应该可以自动地关闭pull request。

同时,John以同样的方式工作着

Mary和Bill一起开发marys-feature,在pull request上讨论的同时,John还在开发他自己的feature分支。通过将功能用不同分支隔离开来,每个人可以独立地工作,但很容易和其他开发者共享修改。

接下来该怎么做

为了彻底了解Github上的功能分支,你应该查看使用分支一章。现在,你应该已经看到了功能分支极大地增强了中心化工作流中单一master分支的作用。除此之外,功能分支还便利了pull request的使用,在版本控制界面上直接讨论特定的提交。Gitflow工作流是管理功能开发、发布准备、维护的常见模式。

Gitflow工作流

下面的Gitflow工作流一节源于nvie网站上的作者Vincent Driessen。

Gitflow工作流围绕项目发布定义了一个严格的分支模型。有些地方比功能分支工作流更复杂,为管理大型项目提供了鲁棒的框架。

和功能分支工作流相比,这种工作流没有增加任何新的概念或命令。它给不同的分支指定了特定的角色,定义它们应该如何、什么时候交流。除了功能分支之外,它还为准备发布、维护发布、记录发布分别使用了单独的分支。当然,你还能享受到功能分支工作流带来的所有好处:pull request、隔离实验和更高效的协作。

如何工作

Gitflow工作流仍然使用中央仓库作为开发者沟通的中心。和其他工作流一样,开发者在本地工作,将分支推送到中央仓库。唯一的区别在于项目的分支结构。

历史分支

和单独的master分支不同,这种工作流使用两个分支来记录项目历史。master分支储存官方发布历史,develop分支用来整合功能分支。同时,这还方便了在master分支上给所有提交打上版本号标签。

工作流剩下的部分围绕这两个分支的差别展开。

功能分支

每个新功能都放置在自己的分支中,可以在备份/协作时推送到中央仓库。但是,与其合并到master,功能分支将开发分支作为父分支。当一个功能完成时,它将被合并回develop。功能永远不应该直接在master上交互。

注意,功能分支加上develop分支就是我们之前所说的功能分支工作流。但是,Gitflow工作流不止于此。

发布分支

一旦develop分支的新功能足够发布(或者预先确定的发布日期即将到来),你可以从develop分支fork一个发布分支。这个分支的创建开始了下个发布周期,只有和发布相关的任务应该在这个分支进行,如修复bug、生成文档等。一旦准备好了发布,发布分支将合并进master,打上版本号的标签。另外,它也应该合并回develop,后者可能在发布启动之后有了新的进展。

使用一个专门的分支来准备发布确保一个团队完善当前的发布,其他团队可以继续开发下一个发布的功能。它还建立了清晰的开发阶段(比如说,“这周我们准备4.0版本的发布”,而我们在仓库的结构中也能看到这个阶段)。

通常我们约定:

  • develop创建分支
  • 合并进master分支
  • 命名规范release-* or release/*

维护分支

维护或者“紧急修复”分支用来快速给产品的发布打上补丁。这是唯一可以从master上fork的分支。一旦修复完成了,它应该被并入masterdevelop分支(或者当前的发布分支),master应该打上更新的版本号的标签。

有一个专门的bug修复开发线使得你的团队能够处理issues,而不打断其他工作流或是要等到下一个发布周期。你可以将维护分支看作在master分支上工作的临时发布分支。

例子

下面的栗子演示了这种工作流如何用来管理发布周期。假设你已经创建了中央仓库。

创建一个开发分支

你要做的第一步是为默认的master分支创建一个互补的develop分支。最简单的办法是在本地创建一个空的develop分支,将它推送到服务器上:

  1.  
    git branch develop
  2.  
    git push -u origin develop

这个分支将会包含项目中所有的历史,而master将包含不完全的版本。其他开发者应该将中央仓库克隆到本地,创建一个分支来追踪develop分支:

  1.  
    git clone ssh://user@host/path/to/repo.git
  2.  
    git checkout -b develop origin/develop

现在所有人都有了一份历史分支的本地副本。

Mary和John开始了新功能

我们的栗子从John和Mary在不同分支上工作开始。他们都要为自己的功能创建单独的分支。他们的功能分支都应该基于develop,而不是master

git checkout -b some-feature develop

他们都使用“编辑、缓存、提交”的一般约定来向功能分支添加提交:

  1.  
    git status
  2.  
    git add <some-file>
  3.  
    git commit

Mary完成了她的功能

在添加了一些提交之后,Mary确信她的功能以及准备好了。如果她的团队使用pull request,现在正是发起pull request的好时候,请求将她的功能并入develop分支。否则,她可以向下面一样,将它并入本地的develop分支,推送到中央仓库:

  1.  
    git pull origin develop
  2.  
    git checkout develop
  3.  
    git merge some-feature
  4.  
    git push
  5.  
    git branch -d some-feature

第一个命令在尝试并入功能分支之前确保develop分支已是最新。注意,功能绝不该被直接并入master。冲突的处理方式和中心化工作流相同。

Mary开始准备发布

当John仍然在他的功能分支上工作时,Mary开始准备项目的第一个官方发布。和开发功能一样,她新建了一个分支来封装发布的准备工作。这也正是发布的版本号创建的一步:

git checkout -b release-0.1 develop

这个分支用来整理提交,充分测试,更新文档,为即将到来的发布做各种准备。它就像是一个专门用来完善发布的功能分支。

一旦Mary创建了这个分支,推送到中央仓库,这次发布的功能便被锁定了。不在develop分支中的功能将被推迟到下个发布周期。

Mary完成了她的发布

一旦发布准备稳妥,Mary将它并入masterdevelop,然后删除发布分支。合并回develop很重要,因为可能已经有关键的更新添加到了发布分支上,而开发新功能需要用到它们。同样的,如果Mary的团队重视代码审查,现在将是发起pull request的完美时机。

  1.  
    git checkout master
  2.  
    git merge release-0.1
  3.  
    git push
  4.  
    git checkout develop
  5.  
    git merge release-0.1
  6.  
    git push
  7.  
    git branch -d release-0.1

发布分支是功能开发(develop)和公开发布(master)之间的过渡阶段。不论什么时候将提交并入master时,你应该为提交打上方便引用的标签:

  1.  
    git tag -a 0.1 -m "Initial public release" master
  2.  
    git push --tags

Git提供了许多钩子,即仓库中特定事件发生时被执行的脚本。当你向中央仓库推送master分支或者标签时,你可以配置一个钩子来自动化构建公开发布。

终端用户发现了一个bug

正式发布之后,Mary回过头来和John一起为下一个发布开发功能。这时,一个终端用户开了一个issue抱怨说当前发布中存在一个bug。为了解决这个bug,Mary(或John)从master创建了一个维护分支,用几个提交修复这个issue,然后直接合并回master

  1.  
    git checkout -b issue-#001 master
  2.  
    # Fix the bug
  3.  
    git checkout master
  4.  
    git merge issue-#001
  5.  
    git push

和发布分支一样,维护分支包含了develop中需要的重要更新,因此Mary同样需要执行这个合并。接下来,她可以删除这个分支了:

  1.  
    git checkout develop
  2.  
    git merge issue-#001
  3.  
    git push
  4.  
    git branch -d issue-#001

接下来该怎么做

现在,希望你已经很熟悉中心化的工作流功能分支工作流和Gitflow工作流。你应该已经可以抓住本地仓库、推送/拉取模式,和Git鲁棒的分支和合并模型的无限潜力。

请记住,教程中呈现的工作流只是可行的实践——而非工作中使用Git的金科玉律。因此,尽情地取其精华,去其糟粕吧。不变的是要让Git为你所用,而不是相反。

Fork工作流

Fork工作流和教程中讨论的其它工作流截然不同。与其使用唯一的服务端仓库作为”中央“代码库,它给予 每个 开发者一个服务端仓库。也就是说每个贡献者都有两个Git仓库,而不是一个:一个私有的本地仓库和一个公开的服务端仓库。

Fork工作流的主要优点在于贡献可以轻易地整合进项目,而不需要每个人都推送到单一的中央仓库。开发者推送到他们 自己的 服务端仓库,只有项目管理者可以推送到官方仓库。这使得管理者可以接受任何开发者的提交,却不需要给他们中央仓库的权限。

结论是,这种分布式的工作流为大型、组织性强的团队(包括不可信的第三方)提供了安全的协作方式。它同时也是开源项目理想的工作流。

如何工作

和其它Git工作流一样,Fork工作流以一个储存在服务端的官方公开项目开场。但新的开发者想参与项目时,他们不直接克隆官方项目。

取而代之地,他们fork一份官方项目,在服务端创建一份副本。这份新建的副本作为他们私有的公开仓库——没有其他开发者可以在上面推送,但他们可以从上面拉取修改(在后面我们会讨论为什么这一点很重要)。在他们创建了服务端副本之后,开发者执行git clone操作,在他们的本地机器上复制一份。这是他们私有的开发环境,正如其他工作流中一样。

当他们准备好发布本地提交时,他们将提交推送到自己的公开仓库——而非官方仓库。然后,他们向主仓库发起一个pull request,让项目维护者知道一个更新做好了合并的准备。如果贡献的代码有什么问题的话,Pull request可以作为一个方便的讨论版。

我为了将功能并入官方代码库,维护者将贡献者的修改拉取到他们的本地仓库,确保修改不会破坏项目,将它合并到本地的master分支,然后将master分支推送到服务端的官方仓库。贡献现在已是项目的一部分,其他开发者应该从官方仓库拉取并同步他们的本地仓库。

中央仓库

“官方”仓库这个概念在Fork工作流中只是一个约定,理解这一点很重要。从技术的角度,Git并看不出每个开发者和官方的公开仓库有什么区别。事实上,官方仓库唯一官方的原因是,它是项目维护者的仓库。

Fork工作流中的分支

所有这些个人的公开仓库只是一个在开发者之间共享分支的约定。每个人仍然可以使用分支来隔离功能,就像在功能分支工作流Gitflow工作流中一样。唯一的区别在于这些分支是如何开始的。在Fork工作流中,它们从另一个开发者的本地仓库拉取而来,而在功能分支和Gitflow分支它们被推送到官方仓库。

例子

项目维护者初始化了中央仓库

和任何基于Git的项目一样,第一步是在服务端创建一个可以被所有项目成员访问到的官方仓库。一般来说,这个仓库同时还是项目维护者的公开仓库。

公开的仓库应该永远是裸的,不管它们是否代表官方代码库。所以项目维护者应该运行下面这样的命令来设置官方仓库:

  1.  
    ssh user@host
  2.  
    git init --bare /path/to/repo.git

Github同时提供了一个图形化界面来替代上面的操作。这和教程中其它工作流设置中央仓库的流程完全一致。如果有必要的话,项目维护者应该将已有的代码库推送到这个仓库中。

开发者fork仓库

接下来,所有开发者需要fork官方仓库。你可以用SSH到服务器,运行git clone将它复制到服务器的另一个地址——fork其实只是服务端的clone。但同样地,Github上开发者只需点一点按钮就可以fork仓库。

在这步之后,每个开发者应该都有了自己的服务端仓库。像官方仓库一样,所有这些仓库都应该是裸仓库。

开发者将fork的仓库克隆到本地

接下来开发者需要克隆他们自己的公开仓库。他们可以用熟悉的git clone命令来完成这一步。

我们的栗子假设使用他们使用Github来托管仓库。记住,在这种情况下,每个开发者应该有他们自己的Github账号,应该用下面的命令克隆服务端仓库:

git clone https://user@github.com/user/repo.git

而教程中的其他工作流使用单一的origin远程连接,指向中央仓库,Fork工作流需要两个远程连接,一个是中央仓库,另一个是开发者个人的服务端仓库。你可以给这些远端取任何名字,约定的做法是将origin作为你fork后的仓库的远端(运行git clone是会自动创建)和upstream作为官方项目。

git remote add upstream https://github.com/maintainer/repo

你需要使用上面的命令来创建上游仓库的远程连接。它使得你轻易地保持本地仓库和官方仓库的进展同步。注意如果你的上游仓库开启了认证(比如它没有开源),你需要提供一个用户名,就像这样:

git remote add upstream https://user@bitbucket.org/maintainer/repo.git

它需要用户从官方代码库克隆或拉取之前提供有效的密码。

开发者进行自己的开发

在他们刚克隆的本地仓库中,开发者可以编辑代码、提交更改,和其它分支中一样创建分支

  1.  
    git checkout -b some-feature
  2.  
    # 编辑代码
  3.  
    git commit -a -m "Add first draft of some feature"

他们所有的更改在推送到公开仓库之前都是完全私有的。而且,如果官方项目已经向前进展了,他们可以用git pull获取新的提交:

git pull upstream master

因为开发者应该在专门的功能分支开发,这一般会产生一个快速向前的合并

开发者发布他们的功能

一旦开发者准备好共享他们的新功能,他们需要做两件事情。第一,他们必须将贡献的代码推送到自己的公开仓库,让其他开发者能够访问到。他们的origin远端应该已经设置好了,所以他们只需要:

git push origin feature-branch

这和其他工作流不同之处在于,origin远端指向开发者个人的服务端仓库,而不是主代码库。

第二,他们需要通知项目维护者,他们想要将功能并入官方代码库。Github提供了一个“New Pull Request”按钮,跳转到一个网页,让你指明想要并入主仓库的分支。一般来说,你希望将功能分支并入上游远端的master分支。

项目维护者整合他们的功能

当项目维护者收到pull request时,他们的工作是决定是否将它并入官方的代码库。他们可以使用下面两种方式之一:

  1. 直接检查pull request中检查代码
  2. 将代码拉取到本地仓库然后手动合并

第一个选项更简单,让维护者查看修改前后的差异,在上面评论,然后通过图形界面执行合并。然而,如果pull request会导致合并冲突,第二个选项就有了必要。在这个情况中,维护者需要从开发者的服务端仓库fetch功能分支,合并到他们本地的master分支,然后解决冲突:

  1.  
    git fetch https://bitbucket.org/user/repo feature-branch
  2.  
    # 检查修改
  3.  
    git checkout master
  4.  
    git merge FETCH_HEAD

一旦修改被整合进本地的master,维护者需要将它推送到服务器上的官方仓库,这样其他开发者也可以访问它:

git push origin master

记住,维护者的origin指向他们的公开仓库,也就是项目的官方代码库。开发者的贡献现在完全并入了项目。

开发者和中央仓库保持同步

因为主代码库已经取得了新的进展,其他开发者应该和官方仓库同步:

git pull upstream master

接下来该怎么做

如果你从SVN迁移而来,Fork工作流看上去是一个比较大的转变。但不要害怕——它只是在Feature分支工作流之上引入了一层抽象。贡献的代码发布到开发者在服务端自己的仓库,而不是在唯一的中央仓库中直接共享分支。

这篇文章解释了一次代码贡献是如何从一个开发者流入官方的master分支的,但相同的方法可以用在将代码贡献整合进任何仓库。比如,如果你团队的一部分成员在一个特定功能上协作,他们可以用自己约定的行为共享修改——而不改变主仓库。

这使得Fork工作流对于松散的团队来说是个非常强大的工具。任何开发者都可以轻而易举地和其他开发者共享修改,任何分支都能高效地并入主代码库。

转自: https://github.com/geeeeeeeeek/git-recipes/wiki

原文地址:http://www.cnblogs.com/itech/p/5188929.html

Git 常见工作流的更多相关文章

  1. Git 常见的一些小命令

        Git 常见的一些命令 关于一些参数比较多,比较复杂的都有单独进行介绍         1. git cherry-pick 挑拣命令,当我们不想合并分支,或者git pull 更新仓库,而是 ...

  2. Git常见命令整理

    Git常见命令整理 + 注释 git init # 初始化本地git仓库(创建新仓库) git config --global user.name "xxx" # 配置用户名 gi ...

  3. git常见错误及解决方案总结

    git常见错误及解决方案总结 使用git在本地创建一个项目的过程  $ makdir ~/hello-world                              //创建一个项目hello- ...

  4. Pull Request的过程、基于git做的协同开发、git常见的一些命令、git实现代码的review、git实现版本的管理、gitlab、GitHub上为开源项目贡献代码

    前言: Pull Request的流程 1.fork 首先是找到自己想要pull request的项目, 然后点击fork按钮,此时就会在你的仓库中多出来一个仓库,格式是:自己的账户名/想要pull ...

  5. Git协同工作流介绍

    git相关的文章和教程非常多,但是系统介绍和了解工作流的人并不多,在使用过程中用错或用偏的也不少,这里分享的是,假设你已经入门的情况下,我们如何去选择适合团队需要的工作流. git优势 这里先唠叨gi ...

  6. git常见错误

    一.如果输: $ git remote add origin git@github.com:djqiang(github帐号名)/gitdemo(项目名).git         提示出错信息:fat ...

  7. idea中git常见使用场景

    工作中多人使用版本控制软件协作开发,常见的应用场景归纳如下: 假设小组中有两个人,组长小张,组员小袁 场景一:小张创建项目并提交到远程Git仓库 场景二:小袁从远程Git仓库上获取项目源码 场景三:小 ...

  8. git常见用法介绍

    1. git help:帮助 git help xxx git xxx --help 2. git init:初始化 git init 3. git config:配置 常见用法 git config ...

  9. git 常见命令 和 git 原理图

    git 工作原理图:git 有4 个仓库 这是 git和 svn 一个巨大的区别,所以git 没网也能提交代码和查看记录. svn 只有2 个仓库 ,一个远程一个本地. 1 创建git 仓库(  参数 ...

随机推荐

  1. Java 动态绑定和多态

    动态绑定和多态 动态绑定是指:"在执行程序期间(而非编译期间),判断引用所指对象的实际类型,调用其相应的方法." 动态绑定(多态)存在的条件 要有继承. 要有重写. 父类引用指向子 ...

  2. finecms

    finecms地址 还不错的国内CMS http://www.dayrui.com/doc/246.html

  3. LintCode-69.二叉树的层次遍历

    二叉树的层次遍历 给出一棵二叉树,返回其节点值的层次遍历(逐层从左往右访问) 样例 给一棵二叉树 {3,9,20,#,#,15,7} : 返回他的分层遍历结果: [     [3],     [9,2 ...

  4. Swift as as!和as?的区别

    1.as的使用场合 1.从派生类转换为基类,向上转类型(upcasting) class Animal{} class Dog:Animal{} let cat = ANimal() let dog ...

  5. GPS定位,根据经纬度查询附近地点的经纬度-sql方法实现

    根据当前所在的坐标点也即经纬度,查找数据库中附近5公里或10公里附近的所有信息的实现,经过查找资料,原来是我高二学的,就是求弦长,数学忘完了,没想到数学还这么有用,数学啊 真是用途太大了. 用到的什么 ...

  6. matlab的二维卷积操作(转)

    MATLAB的conv2函数实现步骤(conv2(A,B)): 其中,矩阵A和B的尺寸分别为ma*na即mb*nb ① 对矩阵A补零,第一行之前和最后一行之后都补mb-1行,第一列之前和最后一列之后都 ...

  7. 【week2】燃尽图

    燃尽图(burn down chart)是在项目完成之前,对需要完成的工作的一种可视化表示.燃尽图有一个Y轴(工作)和X轴(时间).理想情况下,该图表是一个向下的曲线,随着剩余工作的完成,“烧尽”至零 ...

  8. [STAThread] 作用

    [STAThread]是一种线程模型,用在程序的入口方法上(在C#和VB.NET里是Main()方法),来指定当前线程的ApartmentState 是STA. [STAThread]是声明开始线程用 ...

  9. C#基础-连接Access与SQL Server

    1.连接Access数据库 string strConnection = "Provider=Microsoft.Ace.OleDb.12.0; Data Source=" + S ...

  10. 洛谷 P3521 [POI2011]ROT-Tree Rotations 解题报告

    P3521 [POI2011]ROT-Tree Rotations 题意:递归给出给一棵\(n(1≤n≤200000)\)个叶子的二叉树,可以交换每个点的左右子树,要求前序遍历叶子的逆序对最少. 大体 ...