基于git的简单实用的版本管理规范及流程，包括：代码库的分布、人员角色的划分、代码提交合并流程、代码冲突处理、分支管理。
对于企业用户，推荐使用CODING 企业版。

代码库分类

根据代码库分布的位置及作用，分为以下几类：

• 主库：位于服务端，所有开发的代码最终都要合到主库。
• 个人代码库（服务端）：从主库fork出来，位于服务端。每个人自已开发的代码，由本地的git库push到每个人自己的个人代码库（服务端），再由个人代码库（服务端）合入主加。
• 个人工作库：位于每个开发人员的开发机器，从个人代码库（服务端）clone到本地。每个开发人员开发的代码，先commit到个人工作库，再由个人工作库push到个人代码库（服务端）。

人员角色分类

这里说的角色，都是人员在主库上的角色。基于简化的原则，人员分为三类：

• Owner：拥有主库的所有权限。
• Committer：具有将开发人员的合并需求（MR）合入主库的权限。基于安全考虑，我们设置为只能通过MR的方式将代码合入主库，而不能直接push到主库。
• Developer：只能从自己的个人代码库（服务端）提交合并代码的请求（MR），是否能够合入，由Committer进行审核。

在CODING 企业版中，Committer在进行MR之前，可以对Developer提供的代码进行review，输入评审意见，并@给相关人员。

基本流程

在主库已经存在的情况下，日常操作流程如下：

1. 开发人员从主库fork出自己的个人代码库。
2. 开发人员将自己的个人代码库clone到本地，即个人工作库。
3. 开发人员在开发了新代码后（包括新增和修改），先将代码commit到自己的个人工作库，再由个人工作库push到个人代码库。
4. 开发人员提交从个人工作库到主库的MR，Committer审核后，决定是否将MR合入主库。
5. 每个开发人员从主库pull最新代码到个人工作库。

分支管理

• 主库缺省的master分支，是用来向生产环境发布的，所有合入的代码，原则上都必须是稳定的。
• 主库除了master分支外，至少还要有一个活动分支，命名建议为：br_工程名_active，平时日常的开发都基于活动分支开发。即从个人工作库提交MR到主库时，指向的是主库的活动分支。活动分支测试稳定后，将主库的活动分支通过MR的形式，合并到主库的master分支，同时打上tag。
• 如果软件运行过程中发现必须立即修改的bug，则从主库的master分支中，拉出一个bugfix分支。为修复这个bug的所有开发，都基于bugfix分支。待bugfix分支开发完成，并测试稳定后，将bugfix分支以MR的方合入主库的master分支。然后删除bugfix分支，视情况决定是否打tag。

在CODING 企业版中，合并分支的同时，可以选择是否删除源分支，十分方便。

常见问题

此部分内容会根据情况进行相应的增加。

活动分支合入主分支时发生冲突

产生原因

平时基于活动分支开发，如果这个过程中为了修复bug而拉了一个bugfix分支，当bugfix分支开发完成并合入master分支后，如果bugfix分支和活动分支修改了相同的文件，则在活动分支合入master分支时就会产生冲突。

解决方法

1. 从个人代码库（服务端）clone一个库到本地，即专门用于合并的个人工作库。（也可以用之前的个人工作库，但初学都容易混淆，建议单独clone一个。）
2. 从主库的活动分支上pull最新的代码到本地。
3. 从主库的master分支上pull最新的代码到本地。
4. 此时会产生冲突，手工修复冲突，然后先commit到本地的个人工作库，再push到个人代码库（服务端）。
5. 提交从个人工作库（服务端）到主库的MR（此时不会再有冲突），然后由Committer审核后将MR合入主库。

CODING 企业版简介

CODING企业版提供整套企业级的软件研发管理系统，让企业的管理人员可以更好地进⾏研发团队的项⽬管理，便捷而深入地把握开发进度，让开发流程⾼效可控。
CODING企业版从项⽬的管理，到代码管理，直到代码的推送和部署，CODING 企业版提供了一整套的完整解决方案。

企业管理

企业管理提供企业个性化定制、企业概览和统计、项⽬及成员批量管理、项⽬权限一键开关、安全管理等一系列功能，可以满足企业基本管理的需求。

项目管理

提供当前企业最前沿的敏捷开发，全生命周期项⽬和任务管理，帮助企业更好的管理项⽬和任务，以应对快速变化的IT项⽬管理需求。

• 简洁高效的任务指派
• 云端共享的项目文件
• 系统化的 Wiki 知识库
• 多维度的项目统计

代码管理

代码管理提供以Git为基础的日常开发源代码版本管理，包括代码浏览、分⽀管理、发布管理、版本对比、合并请求、项⽬⽹络等，提供强于Git 的代码管理使用体验。

• 代码仓库
• 代码评审
• 发布管理