Git 中的功能分支工作流

功能分支工作流程

这个流行的 Git 工作流程涉及直接在主存储库中为每个新功能或修复创建新分支。它通常用于贡献者可以直接推送到存储库的项目。

这个 Gemstone 概述了使用 Git 功能分支工作流程设置本地存储库以处理和贡献 rocky-linux/documentation 项目的过程。

用户“rockstar”已经 fork 了这个存储库，我们将使用 https://github.com/rockstar/documentation 作为 origin。

先决条件

• 一个 GitHub 账户和一个项目 fork（例如，https://github.com/rockstar/documentation）。
• 已安装 git 和 GitHub CLI (gh)。

过程

1. 如果尚未完成，请克隆您的 fork

git clone https://github.com/rockstar/documentation.git
cd documentation

1. 添加上游远程

git remote add upstream https://github.com/rocky-linux/documentation.git

1. 获取上游更改

git fetch upstream

1. 创建新功能分支

git checkout -b feature-branch-name

1. 进行更改、添加新文件并提交它们

   git add .
   git commit -m "Implementing feature X"
   

2. 保持您的分支更新。定期合并上游的更改以避免冲突

   git pull upstream main --rebase
   

3. 推送到您的 fork，输入

git push origin feature-branch-name

1. 创建拉取请求

gh pr create --base main --head rockstar:feature-branch-name --title "New Feature X" --body "Long Description of the feature"

结论

功能分支工作流程是一种常见的协作技术，它允许团队在保持主代码库稳定的同时，并行处理项目的各个方面。

涉及的高级步骤包括：

1. 克隆主存储库：直接将主项目存储库克隆到您的本地计算机。
2. 创建功能分支：为每个新任务，从主分支创建一个具有描述性名称的新分支。
3. 提交更改：在您的分支中处理功能或修复，并提交更改。
4. 保持分支更新：定期与主分支合并或变基，以保持对更改的了解。
5. 打开拉取请求：将分支推送到主存储库，并在功能准备好后打开一个 PR 以供审查。
6. 代码审查和合并：分支在审查和批准后合并到主分支。

优势:

• 简化了具有直接存储库访问权限的常规贡献者的贡献。
• 确保每个功能在集成到主代码库之前都经过审查。
• 有助于维护清晰且线性的项目历史。

作者：Wale Soyinka

贡献者：Ganna Zhyrnova