GitLab - 创建分支

GitLab - 创建和管理分支

什么是分支？

在 Git 中，分支（branch）是一条独立的开发线。可以将其视为一个单独的工作空间，您可以在其中处理新功能、错误修复或进行实验，而不会影响主代码库（通常称为 ‘main’ 或 ‘master’）。一旦分支上的工作完成并经过测试，就可以将其合并回主分支。

在现代软件开发中，使用分支至关重要，原因如下：

• 并行开发：多个开发者可以同时处理不同的功能。
• 隔离：在一个分支上的更改在明确合并之前不会影响其他分支。
• 实验：可以安全地尝试新想法，而不会危及主代码库的稳定性。
• 有序的工作流程：功能分支（feature branch）、错误修复分支（bugfix branch）和发布分支（release branch）有助于组织开发流程。

使用命令行创建分支（推荐）

创建分支最常见的方式是通过 Git 命令行界面（CLI）。

步骤 1：导航到您的本地项目目录。

$ cd /path/to/your/project

步骤 2：确保您当前的分支（例如，main）与远程仓库保持最新。

$ git checkout main
$ git pull origin main

步骤 3：创建并切换到新分支。git checkout -b <branch-name> 命令会从您当前的分支创建一个新分支，并立即切换到该分支。

$ git checkout -b feature/new-login-page
Switched to a new branch 'feature/new-login-page'

或者，使用 git switch -c <branch-name> 命令（在较新的 Git 版本中可用）：

$ git switch -c feature/new-login-page
Switched to a new branch 'feature/new-login-page'

分支命名最佳实践：使用描述性的名称。常见的命名约定包括使用前缀，如 feature/、bugfix/、hotfix/、release/，后跟简短的描述性名称（例如，feature/user-authentication、bugfix/issue-123）。

步骤 4：将新分支推送到 GitLab。为了让您的分支对其他人可见并在 GitLab 上可用，您需要将其推送到远程仓库（通常命名为 ‘origin’）。

$ git push -u origin feature/new-login-page

-u 标志（或 --set-upstream）会在您的本地分支和远程分支之间建立跟踪关系。这样，您将来就可以在该分支上直接使用 git pull 和 git push，而无需指定远程仓库和分支名称。

通过 GitLab UI 创建分支

您也可以直接从 GitLab Web 界面创建分支。

步骤 1：登录您的 GitLab 账户，然后导航到您的项目。

步骤 2：在左侧边栏中，转到 ‘Repository’（仓库），然后选择 ‘Branches’（分支）。

此导航路径的文字描述可能是：您的项目 > Repository（仓库） > Branches（分支）。

步骤 3：在 ‘Branches’（分支）页面上，点击 ‘New branch’（新建分支）按钮。此按钮通常位于页面的右上角。

步骤 4：在 ‘New branch’（新建分支）表单中：

• 输入 ‘Branch name’（分支名称）（例如，feature/documentation-update）。
• 选择 ‘Create from’（创建来源）。这是用于创建新分支的现有分支、标签（tag）或提交（commit）。通常情况下，您会从 main 或另一个功能分支创建它。

步骤 5：点击 ‘Create branch’（创建分支）按钮。

创建后，您将进入 GitLab 中新分支的页面。要在本地处理此分支，通常会运行：

$ git fetch origin
$ git checkout feature/documentation-update

列出分支

查看所有本地分支：

$ git branch

查看所有远程分支：

$ git branch -r

查看所有本地和远程分支：

$ git branch -a

切换分支

切换到现有本地分支：

$ git checkout <branch-name>
# 或使用较新的 Git 版本：
$ git switch <branch-name>

删除分支

删除本地分支（合并后）：

$ git branch -d <branch-name>

删除 GitLab 上的远程分支：

$ git push origin --delete <branch-name>

分支是 Git 工作流程的核心部分，GitLab 通过其 UI 和结合 Git CLI 命令提供了出色的工具来管理它们。