mirror of
https://github.com/oldratlee/translations.git
synced 2026-02-03 02:04:13 +08:00
250 lines
12 KiB
Markdown
250 lines
12 KiB
Markdown
集中式工作流
|
||
=================================
|
||
|
||
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
|
||
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
|
||
|
||
|
||
- [🍺 工作方式](#-%E5%B7%A5%E4%BD%9C%E6%96%B9%E5%BC%8F)
|
||
- [冲突解决](#%E5%86%B2%E7%AA%81%E8%A7%A3%E5%86%B3)
|
||
- [🍺 示例](#-%E7%A4%BA%E4%BE%8B)
|
||
- [有人先初始化好中央仓库](#%E6%9C%89%E4%BA%BA%E5%85%88%E5%88%9D%E5%A7%8B%E5%8C%96%E5%A5%BD%E4%B8%AD%E5%A4%AE%E4%BB%93%E5%BA%93)
|
||
- [所有人克隆中央仓库](#%E6%89%80%E6%9C%89%E4%BA%BA%E5%85%8B%E9%9A%86%E4%B8%AD%E5%A4%AE%E4%BB%93%E5%BA%93)
|
||
- [小明开发功能](#%E5%B0%8F%E6%98%8E%E5%BC%80%E5%8F%91%E5%8A%9F%E8%83%BD)
|
||
- [小红开发功能](#%E5%B0%8F%E7%BA%A2%E5%BC%80%E5%8F%91%E5%8A%9F%E8%83%BD)
|
||
- [小明发布功能](#%E5%B0%8F%E6%98%8E%E5%8F%91%E5%B8%83%E5%8A%9F%E8%83%BD)
|
||
- [小红试着发布功能](#%E5%B0%8F%E7%BA%A2%E8%AF%95%E7%9D%80%E5%8F%91%E5%B8%83%E5%8A%9F%E8%83%BD)
|
||
- [小红在小明的提交之上`rebase`](#%E5%B0%8F%E7%BA%A2%E5%9C%A8%E5%B0%8F%E6%98%8E%E7%9A%84%E6%8F%90%E4%BA%A4%E4%B9%8B%E4%B8%8Arebase)
|
||
- [小红解决合并冲突](#%E5%B0%8F%E7%BA%A2%E8%A7%A3%E5%86%B3%E5%90%88%E5%B9%B6%E5%86%B2%E7%AA%81)
|
||
- [小红成功发布功能](#%E5%B0%8F%E7%BA%A2%E6%88%90%E5%8A%9F%E5%8F%91%E5%B8%83%E5%8A%9F%E8%83%BD)
|
||
- [🍺 下一站](#-%E4%B8%8B%E4%B8%80%E7%AB%99)
|
||
|
||
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
|
||
|
||
|
||
|
||
转到分布式版本控制系统看起来像个令人生畏的任务，但不改变已用的工作流你也可以用上`Git`带来的收益。团队可以用和`Subversion`完全不变的方式来开发项目。
|
||
|
||
但使用`Git`加强开发的工作流，`Git`有相比`SVN`的几个优势。
|
||
首先，每个开发可以有属于自己的整个工程的本地拷贝。隔离的环境让各个开发者的工作和项目的其他部分修改独立开来 ——
|
||
即自由地提交到自己的本地仓库，先完全忽略上游的开发，直到方便的时候再把修改反馈上去。
|
||
|
||
其次，`Git`提供了强壮的分支和合并模型。不像`SVN`，`Git`的分支设计成可以做为一种用来在仓库之间集成代码和分享修改的『失败安全』的机制。
|
||
|
||
🍺 工作方式
|
||
---------------------
|
||
|
||
像`Subversion`一样，集中式工作流以中央仓库作为项目所有修改的单点实体。相比`SVN`缺省的开发分支`trunk`，`Git`叫做`master`，所有修改提交到这个分支上。本工作流只用到`master`这一个分支。
|
||
|
||
开发者开始先克隆中央仓库。在自己的项目拷贝中像`SVN`一样的编辑文件和提交修改；但修改是存在本地的，和中央仓库是完全隔离的。开发者可以把和上游的同步延后到一个方便时间点。
|
||
|
||
要发布修改到正式项目中，开发者要把本地`master`分支的修改『推』到中央仓库中。这相当于`svn commit`操作，但`push`操作会把所有还不在中央仓库的本地提交都推上去。
|
||
|
||
|
||
|
||
### 冲突解决
|
||
|
||
|
||
中央仓库代表了正式项目，所以提交历史应该被尊重且是稳定不变的。如果开发者本地的提交历史和中央仓库有分歧，`Git`会拒绝`push`提交否则会覆盖已经在中央库的正式提交。
|
||
|
||
|
||
|
||
在开发者提交自己功能修改到中央库前，需要先`fetch`在中央库的新增提交，`rebase`自己提交到中央库提交历史之上。
|
||
这样做的意思是在说，『我要把自己的修改加到别人已经完成的修改上。』最终的结果是一个完美的线性历史，就像以前的`SVN`的工作流中一样。
|
||
|
||
如果本地修改和上游提交有冲突，`Git`会暂停`rebase`过程，给你手动解决冲突的机会。`Git`解决合并冲突，用和生成提交一样的[`git status`](https://www.atlassian.com/git/tutorials/inspecting-a-repository#git-status)和[`git add`](https://www.atlassian.com/git/tutorials/saving-changes#git-add)命令，很一致方便。还有一点，如果解决冲突时遇到麻烦，`Git`可以很简单中止整个`rebase`操作，重来一次（或者让别人来帮助解决）。
|
||
|
||
🍺 示例
|
||
---------------------
|
||
|
||
让我们一起逐步分解来看看一个常见的小团队如何用这个工作流来协作的。有两个开发者小明和小红，看他们是如何开发自己的功能并提交到中央仓库上的。
|
||
|
||
### 有人先初始化好中央仓库
|
||
|
||
|
||
|
||
第一步，有人在服务器上创建好中央仓库。如果是新项目，你可以初始化一个空仓库；否则你要导入已有的`Git`或`SVN`仓库。
|
||
|
||
中央仓库应该是个裸仓库（`bare repository`），即没有工作目录（`working directory`）的仓库。可以用下面的命令创建：
|
||
|
||
```bash
|
||
ssh user@host
|
||
git init --bare /path/to/repo.git
|
||
```
|
||
|
||
确保写上有效的`user`（`SSH`的用户名），`host`（服务器的域名或IP地址），`/path/to/repo.git`（你想存放仓库的位置）。
|
||
注意，为了表示是一个裸仓库，按照约定加上`.git`扩展名到仓库名上。
|
||
|
||
### 所有人克隆中央仓库
|
||
|
||
|
||
|
||
下一步，各个开发者创建整个项目的本地拷贝。通过[`git clone`](https://www.atlassian.com/git/tutorials/setting-up-a-repository#git-clone)命令完成：
|
||
|
||
```bash
|
||
git clone ssh://user@host/path/to/repo.git
|
||
```
|
||
|
||
基于你后续会持续和克隆的仓库做交互的假设，克隆仓库时`Git`会自动添加远程别名`origin`指回『父』仓库。
|
||
|
||
### 小明开发功能
|
||
|
||
|
||
|
||
在小明的本地仓库中，他使用标准的`Git`过程开发功能：编辑、暂存（`Stage`）和提交。
|
||
如果你不熟悉暂存区（`Staging Area`），这里说明一下：**暂存区** 用来准备一个提交，但可以不用把工作目录中所有的修改内容都包含进来。
|
||
这样你可以创建一个高度聚焦的提交，尽管你本地修改很多内容。
|
||
|
||
```bash
|
||
git status # 查看本地仓库的修改状态
|
||
git add # 暂存文件
|
||
git commit # 提交文件
|
||
```
|
||
|
||
请记住，因为这些命令生成的是本地提交，小明可以按自己需求反复操作多次，而不用担心中央仓库上有了什么操作。
|
||
对需要多个更简单更原子分块的大功能，这个做法是很有用的。
|
||
|
||
|
||
### 小红开发功能
|
||
|
||
|
||
|
||
与此同时，小红在自己的本地仓库中用相同的编辑、暂存和提交过程开发功能。和小明一样，她也不关心中央仓库有没有新提交；
|
||
当然更不关心小明在他的本地仓库中的操作，因为所有本地仓库都是私有的。
|
||
|
||
### 小明发布功能
|
||
|
||
|
||
|
||
一旦小明完成了他的功能开发，会发布他的本地提交到中央仓库中，这样其它团队成员可以看到他的修改。他可以用下面的[`git push`命令](https://www.atlassian.com/git/tutorials/syncing#git-push)：
|
||
|
||
```bash
|
||
git push
|
||
|
||
# 【译注】：
|
||
# 原文用的命令是 git push origin master
|
||
#
|
||
# 主流的git版本，可以省略后面2个参数：远程仓库别名、推送分支，
|
||
# 因为这2个参数缺省分别就是 origin 、 当前分支（本文目前的示例就是master）。
|
||
# 这样的用法更简单自然，我平时就是这么用的。
|
||
```
|
||
|
||
注意，`origin`是在小明克隆仓库时`Git`创建的远程中央仓库别名。`master`参数告诉`Git`推送的分支。
|
||
由于中央仓库自从小明克隆以来还没有被更新过，所以`push`操作不会有冲突，成功完成。
|
||
|
||
### 小红试着发布功能
|
||
|
||
|
||
|
||
一起来看看在小明发布修改后，小红`push`修改会怎么样？她使用完全一样的`push`命令：
|
||
|
||
```bash
|
||
git push
|
||
|
||
# 【译注】：
|
||
# 原文用的命令是 git push origin master
|
||
# 原因同上
|
||
```
|
||
|
||
但她的本地历史已经和中央仓库有分岐了，`Git`拒绝操作并给出下面很长的出错消息：
|
||
|
||
```py
|
||
error: failed to push some refs to '/path/to/repo.git'
|
||
hint: Updates were rejected because the tip of your current branch is behind
|
||
hint: its remote counterpart. Merge the remote changes (e.g. 'git pull')
|
||
hint: before pushing again.
|
||
hint: See the 'Note about fast-forwards' in 'git push --help' for details.
|
||
```
|
||
|
||
这避免了小红覆写正式的提交。她要先`pull`小明的更新到她的本地仓库合并上她的本地修改后，再重试。
|
||
|
||
### 小红在小明的提交之上`rebase`
|
||
|
||
|
||
|
||
小红用[`git pull`](https://www.atlassian.com/git/tutorials/syncing#git-pull)合并上游的修改到自己的仓库中。
|
||
这条命令类似`svn update`——拉取所有上游提交命令到小红的本地仓库，并尝试和她的本地修改合并：
|
||
|
||
```bash
|
||
git pull --rebase
|
||
|
||
# 【译注】：
|
||
# 原文用的命令是 git pull --rebase origin master
|
||
# 原因同上
|
||
```
|
||
|
||
`--rebase`选项告诉`Git`把小红的提交移到同步了中央仓库修改后的`master`分支的顶部，如下图所示：
|
||
|
||
|
||
|
||
如果你忘加了这个选项，`pull`操作仍然可以完成，但每次`pull`操作要同步中央仓库中别人修改时，提交历史会以一个多余的『合并提交』结尾。
|
||
对于集中式工作流，最好是使用`rebase`而不是生成一个合并提交。
|
||
|
||
### 小红解决合并冲突
|
||
|
||
|
||
|
||
`rebase`操作过程是把本地提交一次一个地迁移到更新了的中央仓库`master`分支之上。
|
||
这意味着可能要解决在迁移某个提交时出现的合并冲突，而不是解决包含了所有提交的大型合并时所出现的冲突。
|
||
这样的方式让你尽可能保持每个提交的聚焦和项目历史的整洁。反过来，简化了哪里引入`Bug`的分析，如果有必要，回滚修改也可以做到对项目影响最小。
|
||
|
||
如果小红和小明的功能是不相关的，不大可能在`rebase`过程中有冲突。如果有，`Git`在合并有冲突的提交处暂停`rebase`过程，输出下面的信息并带上相关的指令：
|
||
|
||
```
|
||
CONFLICT (content): Merge conflict in <some-file>
|
||
```
|
||
|
||
|
||
|
||
`Git`很赞的一点是，任何人可以解决他自己的冲突。在这个例子中，小红可以简单的运行[`git status`](https://www.atlassian.com/git/tutorials/inspecting-a-repository#git-status)命令来查看哪里有问题。
|
||
冲突文件列在`Unmerged paths`（未合并路径）一节中：
|
||
|
||
```
|
||
# Unmerged paths:
|
||
# (use "git reset HEAD <some-file>..." to unstage)
|
||
# (use "git add/rm <some-file>..." as appropriate to mark resolution)
|
||
#
|
||
# both modified: <some-file>
|
||
```
|
||
|
||
接着小红编辑这些文件。修改完成后，用老套路暂存这些文件，并让[`git rebase`](https://www.atlassian.com/git/tutorials/rewriting-history#git-rebase)完成剩下的事：
|
||
|
||
```bash
|
||
git add <some-file>
|
||
git rebase --continue
|
||
```
|
||
|
||
要做的就这些了。`Git`会继续一个一个地合并后面的提交，如其它的提交有冲突就重复这个过程。
|
||
|
||
如果你碰到了冲突，但发现搞不定，不要惊慌。只要执行下面这条命令，就可以回到你执行[`git pull --rebase`](https://www.atlassian.com/git/tutorials/syncing#git-pull)命令前的样子：
|
||
|
||
```bash
|
||
git rebase --abort
|
||
```
|
||
|
||
### 小红成功发布功能
|
||
|
||
|
||
|
||
小红完成和中央仓库的同步后，就能成功发布她的修改了：
|
||
|
||
```bash
|
||
git push
|
||
|
||
# 【译注】：
|
||
# 原文用的命令是 git push origin master
|
||
# 原因同上
|
||
```
|
||
|
||
🍺 下一站
|
||
-----------------
|
||
|
||
如你所见，仅使用几个`Git`命令我们就可以模拟出传统`Subversion`开发环境。对于要从`SVN`迁移过来的团队来说这太好了，但没有发挥出`Git`分布式本质的优势。
|
||
|
||
如果你的团队适应了集中式工作流，但想要更流畅的协作效果，绝对值得探索一下[功能分支工作流](workflow-feature-branch.md)的收益。
|
||
通过为一个功能分配一个专门的分支，能够做到一个新增功能集成到正式项目之前对新功能进行深入讨论。
|
||
|
||
-----------------
|
||
|
||
[« 概述](README.md) [功能分支工作流 »](workflow-feature-branch.md)
|