Git 多人合作、分支管理

矫情吗；* 2022-06-06 12:47 303阅读 0赞

# Git 多人合作、分支管理  #

# 源仓库 #

在项目的开始，项目的发起者构建起一个项目的最原始的仓库，我们把它称为origin，例如我们的Una项目，origin就是这个项目的源仓库了。

##### 源仓库的有两个作用： #####

1、汇总参与该项目的各个开发者的代码  
2、存放趋于稳定和可发布的代码  
源仓库应该是受保护的，开发者不应该直接对其进行开发工作。只有项目管理者（通常是项目发起人）能对其进行较高权限的操作。

##### 开发者仓库 #####

上面说过，任何开发者都不会对源仓库进行直接的操作，源仓库建立以后，每个开发者需要做的事情就是fork一份源仓库，作为自己日常开发的仓库。

每个开发者所fork的仓库是完全独立的，互不干扰，甚至与源仓库都无关。每个开发者仓库相当于一个源仓库实体的影像，开发者在这个影像中进行编码，提交到自己的仓库中，这样就可以轻易地实现团队成员之间的并行开发工作。而开发工作完成以后，开发者可以向源仓库发送pull request，请求管理员把自己的代码合并到源仓库中，这样就实现了分布式开发工作，和最后的集中式的管理。

Git鼓励大量使用分支：
    查看分支：git branch
    创建分支：git branch <name>
    切换分支：git checkout <name>
    创建+切换分支：git checkout -b <name>
    合并某分支到当前分支：git merge <name>
    删除分支：git branch -d <name>

# 分支（Branch） #

分支是git中非常重要的一个概念，也是git这一个工具中的大杀器，必杀技。在其他集中式版本管理工具（SVN/CVS）把分支定位为高级技巧，而在git中，分支操作则是每个开发人员日常工作流。利用git的分支，可以非常方便地进行开发和测试，如果使用git没有让你感到轻松和愉悦，那是因为你还没有学会使用分支。不把分支用出一点翔来，不要轻易跟别人说你用过git。

在文章开头的那张图中，每一个矩形内部纷繁的枝蔓便是git的分支模型。可以看出，每个开发者的仓库都有自己的分支路线，而这些分支路线会通过代码汇总映射到源仓库中去。

我们为git定下一种分支模型，在这种模型中，分支有两类，五种

永久性分支
    master branch：主分支
    develop branch：开发分支
    临时性分支
    feature branch：功能分支
    release branch：预发布分支
    hotfix branch：bug修复分支

##### 永久性分支 #####

永久性分支是寿命无限的分支，存在于整个项目的开始、开发、迭代、终止过程中。永久性分支只有两个master和develop。

master：主分支从项目一开始便存在，它用于存放经过测试，已经完全稳定代码；在项目开发以后的任何时刻当中，master存放的代码应该是可作为产品供用户使用的代码。所以，应该随时保持master仓库代码的清洁和稳定，确保入库之前是通过完全测试和代码reivew的。master分支是所有分支中最不活跃的，大概每个月或每两个月更新一次，每一次master更新的时候都应该用git打上tag，说明你的产品有新版本发布了。

develop：开发分支，一开始从master分支中分离出来，用于开发者存放基本稳定代码。之前说过，每个开发者的仓库相当于源仓库的一个镜像，每个开发者自己的仓库上也有master和develop。开发者把功能做好以后，是存放到自己的develop中，当测试完以后，可以向管理者发起一个pull request，请求把自己仓库的develop分支合并到源仓库的develop中。

所有开发者开发好的功能会在源仓库的develop分支中进行汇总，当develop中的代码经过不断的测试，已经逐渐趋于稳定了，接近产品目标了。这时候，我们就可以把develop分支合并到master分支中，发布一个新版本。所以，一个产品不断完善和发布过程就正如下图：

![main-branches_2x.png][]

注意，任何人不应该向master直接进行无意义的合并、提交操作。正常情况下，master只应该接受develop的合并，也就是说，master所有代码更新应该源于合并develop的代码。

##### 暂时性分支 #####

暂时性分支和永久性分支不同，暂时性分支在开发过程中是一定会被删除的。所有暂时性分支，一般源于develop，最终也一定会回归合并到develop。

feature：功能性分支，是用于开发项目的功能的分支，是开发者主要战斗阵地。开发者在本地仓库从develop分支分出功能分支，在该分支上进行功能的开发，开发完成以后再合并到develop分支上，这时候功能性分支已经完成任务，可以删除。功能性分支的命名一般为feature-，为需要开发的功能的名称。

![fb_2x.png][]

举一个例子，假设我是一名PingHackers网站的开发者，已经把源仓库fork了，并且clone到了本地。现在要开发PingHackers网站的“讨论”功能。我在本地仓库中可以这样做：

step 1: 切换到develop分支

>>> git checkout develop

step 2: 分出一个功能性分支

>>> git checkout -b feature-discuss

step 3: 在功能性分支上进行开发工作，多次commit，测试以后...  
step 4: 把做好的功能合并到develop中

>>> git checkout develop
    # 回到develop分支
    >>> git merge --no-ff feature-discuss
    # 把做好的功能合并到develop中
    >>> git branch -d feature-discuss
    # 删除功能性分支
    >>> git push origin develop
    # 把develop提交到自己的远程仓库中

这样，就完成一次功能的开发和提交。

release：预发布分支，当产品即将发布的时候，要进行最后的调整和测试，这时候就可以分出一个预发布分支，进行最后的bug fix。测试完全以后，发布新版本，就可以把预发布分支删除。预发布分支一般命名为release-\*。

hotfix：修复bug分支，当产品已经发布了，突然出现了重大的bug。这时候就要新建一个hotfix分支，继续紧急的bug修复工作，当bug修复完以后，把该分支合并到master和develop以后，就可以把该分支删除。修复bug分支命名一般为hotfix-\*

release和hotfix分支离我们还比较遥远。。

> 上面大体介绍了git多人合作的思路，下面是具体步骤

# 一、基本设置 #

## 1、github相关 ##

### 注册github，创建仓库，配置SSH Key ###

<1>注册github（不必多说）

<2>创建仓库  
可以创建public和private仓库，当然private需要掏钱。  
一般我们只需要创建public 仓库，需要配置README和忽略文件，以及开源协议

<3>配置SSH Key，只有配置他之后，你的电脑才能和github相关联。以下为具体步骤：

（1）使用ssh-keygen命令生成key pair：  
$ssh-keygen -t rsa -C "$\{YourEmail\}" \# "-t rsa"表示使用密钥的加密类型，还可以为dsa；-C设置注释文字，比如你的邮箱“YourEmail”，不一定要是github注册邮箱  
Enter file in which to save the key (/Users/faner/.ssh/id\_rsa): \# 直接回车  
Enter passphrase (empty for no passphrase): \# 输入密钥文件授权密码  
Enter same passphrase again: \# 确认密钥文件授权密码  
Your identification has been saved in /Users/faner/.ssh/id\_rsa.  
Your public key has been saved in /Users/faner/.ssh/id\_rsa.pub.

（2）此时，敲入ls命令可以看到ssh-keygen在~/.ssh目录下生成的public/private key pair，其中id\_rsa为密钥对中的私钥，需妥善保管；id\_rsa.pub为密钥对中的公钥，可任意公开。  
RSA是一种支持变长密钥的公共密钥算法，需要加密的文件块的长度也是可变的。DSA(Digital Signature Algorithm，数字签名算法)是一种标准的DSS（数字签名标准）。  
id\_rsa私钥类似keychain进行CSR时生成的private key；id\_rsa.pub公钥则类似CSR申请下来的开发证书（在Apple Member Center中有在线备案）。  
通过cat命令可以查看id\_rsa.pub内容。  
\*git checkout develop  
只有这样你的xcode和终端的命令才保持一致  
（3）github上，进入setting，打开SSH key进行设置就OK了

## 2、Xcode相关 ##

### （1）clone远程源仓库 ###

终端进入存放代码的目录，使用以下命令clone。注意此时你clone下来的是github上整个文件夹

git clone "remote address"

### （2）创建新项目，放到clone下来的文件夹下 ###

进入本地仓库目录

cd 项目同级目录

切换到develop分支，此时已经从远程拉取develop分支

git checkout develop

将本地新项目提交到本地develop分支

git add .
    git commit -m "初始化项目"

此时本地develop分支已经有你新建的项目，上传到远程develop分支。

这里可以使用Xcode自带的push功能，push到远程develop分支

至此，项目已经初始化完成。。  
至于实际开发中如何正确操作，可以参考实例演练

# 3、实例演练 #

举一个例子，假设我是一名网站的开发者，已经把源仓库fork了，并且clone到了本地。现在要开发网站的“讨论”功能。我在本地仓库中可以这样做：

step 1: 切换到develop分支

>>> git checkout develop

step 2: 分出一个功能性分支

>>> git checkout -b feature-discuss

step 3: 在功能性分支上进行开发工作，多次commit，测试以后...

step 4: 把做好的功能合并到develop中

>>> git checkout develop
    
    # 回到develop分支
    
    >>> git merge --no-ff feature-discuss
    # 把做好的功能合并到develop中
    
    >>> git branch -d feature-discuss
    # 删除功能性分支
    
    >>> git push origin develop
    # 把develop提交到自己的远程仓库中

这样，就完成一次功能的开发和提交。  
这是用终端操作，使用xcode自带功能会更方便。

# 4、合并远程master和develop分支 #

前提条件是本地代码已经全部提交到远程develop分支；  
首先在本地的develop分支pull远程develop代码；  
切换到master分支，从远程pull代码，将develop分支合并到本地master分支（此时本地master分支是与远程同步的），有冲突解决，没有则罢。  
最后push到远程master仓库。

[main-branches_2x.png]: /images/20220606/ae01fdd6e0bf43bd9e9f6e65e0247460.png
[fb_2x.png]: /images/20220606/7655baecce69411bb339a204b797e08e.png