轻松删除 GitLab 分支：图文教程 – wiki基地

轻松删除 GitLab 分支：告别冗余，让你的代码仓库井然有序

引言：为什么需要删除分支？

随着项目的迭代开发，GitLab 仓库中的分支会越来越多。除了长期存在的主分支（如 main、master、develop）和发布分支（如 release-x.x）之外，大量的特性分支（feature branches）、修复分支（bugfix branches）和实验性分支（experimental branches）在完成其使命（通常是合并到主线分支）后，便成为了历史遗留物。

这些冗余的分支会带来诸多问题：

视觉混乱： 分支列表变得冗长，难以快速找到当前活跃的分支。
管理负担： 维护者需要花费更多精力去理解哪些分支仍然重要。
潜在误导： 过时的分支可能会误导团队成员，让他们基于错误的基础进行开发。
轻微性能影响： 虽然不显著，但大量无用引用会增加 Git 操作（如 git fetch）的开销。

因此，定期清理和删除不再需要的分支，是维护一个健康、整洁、易于管理的 GitLab 代码仓库的关键步骤。本文将为你提供一份详细的图文教程，介绍通过 GitLab Web 界面和 Git 命令行两种主要方式，轻松删除你的 GitLab 分支。我们将覆盖删除单个分支、删除已合并分支以及需要注意的事项。

方法一：通过 GitLab Web 界面删除分支

这是对于大多数用户来说最直观、最简单的方式，无需记住 Git 命令。

步骤 1：导航到项目分支列表

首先，登录你的 GitLab 账户，找到你需要清理分支的项目。

在项目页面的左侧导航菜单中，找到并点击 “Repository” (仓库)，然后在展开的子菜单中选择 “Branches” (分支)。

[图片：GitLab 项目页面左侧导航，高亮显示 Repository -> Branches]

点击 “Branches” 后，你将看到该项目下的所有分支列表。

[图片：GitLab 分支列表页面，显示所有分支及其信息（名称、提交信息、作者、更新时间、删除按钮等）]

这个页面展示了每个分支的名称、最近的提交信息、提交者、最后更新时间，以及一个重要的操作按钮——删除按钮。

步骤 2：定位并删除单个分支

在分支列表中，找到你想要删除的特定分支。请仔细核对分支名称，确保你不会误删重要分支。

在目标分支所在行的最右侧，你会看到一个红色的垃圾桶图标 🗑️。这就是删除分支的按钮。

[图片：GitLab 分支列表页面，高亮显示某个分支行最右侧的红色垃圾桶图标]

点击这个垃圾桶图标。

系统会弹出一个确认对话框，询问你是否确定要删除该分支。这是防止误操作的二次确认。对话框中会明确显示即将被删除的分支名称。

[图片：删除分支确认对话框，显示要删除的分支名称和确认/取消按钮]

请再次确认分支名称无误。如果确认删除，点击对话框中的 “Delete branch” (删除分支) 按钮。

[图片：删除分支确认对话框，高亮显示 “Delete branch” 按钮]

如果删除成功，页面会刷新，该分支将不再出现在分支列表中。通常会有一个短暂的通知提示删除成功。

注意： 重要的分支，如受保护的分支（Protected Branches），其右侧不会显示删除按钮，或者显示为灰色不可点击，以防止误删。

步骤 3：通过合并请求删除已合并分支（推荐工作流）

在日常开发中，特性分支通常在完成开发并合并到目标分支（如 main 或 develop）后，就可以被删除了。GitLab 提供了一种与合并请求 (Merge Request, MR) 工作流紧密集成的删除方式，这是最常见且推荐的清理特性分支的方法。

方法 A: 在创建或编辑合并请求时设置

当你创建一个新的合并请求时，或者编辑一个已有的合并请求时，在 MR 的设置区域通常有一个选项：“Delete source branch when merge request is accepted” (接受合并请求后删除源分支)。

[图片：GitLab 创建/编辑合并请求页面，高亮显示“接受合并请求后删除源分支”复选框]

勾选这个复选框。

当你接受（Accept）并合并这个合并请求后，GitLab 会自动删除作为源分支的特性分支。这极大地简化了合并后的清理工作。

方法 B: 在合并请求接受后手动点击删除

即使你在创建 MR 时没有勾选自动删除选项，或者因为某些原因没有自动删除成功，GitLab 在合并请求被接受并关闭后，通常会在该 MR 的页面上显示一个按钮，用于方便地删除源分支。

[图片：GitLab 已关闭的合并请求页面，显示“Delete source branch”按钮（或者类似文字，如“删除源分支”）]

在合并请求页面顶部或底部附近，找到这个按钮并点击它。系统可能会要求你再次确认删除。

[图片：删除源分支确认对话框（如果弹出）]

点击确认后，该源分支就会被删除。

这种通过合并请求删除分支的方式，确保了只有在分支的更改被成功合入主线后才进行删除，降低了误删的风险。

步骤 4：删除已合并的分支（通过分支列表过滤）

GitLab 的分支列表页面通常提供了过滤功能。你可以过滤出所有已经合并到特定目标分支（如 main 或 develop）的分支。

在 Branches 页面的顶部或侧边，找到过滤选项。选择或输入你想过滤的合并状态，例如选择 “Merged” (已合并)，并指定目标分支（例如 main）。

[图片：GitLab 分支列表页面顶部的过滤区域，高亮显示“Merged”过滤条件和目标分支选择]

应用过滤后，列表将只显示已经合并到指定目标分支的分支。对于这些分支，它们右侧的垃圾桶图标通常是可用的。

[图片：过滤后的分支列表，只显示已合并分支，并且其删除按钮可用]

你可以逐个点击这些已合并分支右侧的垃圾桶图标进行删除，就像步骤 2 描述的那样。

是否有批量删除已合并分支的按钮？

在某些版本的 GitLab 或特定的设置下，当你过滤出已合并分支后，GitLab 可能会在页面顶部提供一个 “Remove merged branches” (删除已合并分支) 的便捷按钮。

[图片：GitLab 分支列表页面，过滤出已合并分支后，页面顶部可能出现的“Remove merged branches”按钮]

如果你的 GitLab 实例有这个按钮，点击它将可以一次性删除列表中所有已合并且非受保护的分支。这是一个非常高效的清理方式。点击后通常需要再次确认操作。

[图片：批量删除已合并分支的确认对话框]

请注意，这个批量删除按钮只会删除已合并且非受保护的分支。

方法二：通过 Git 命令行删除分支

对于习惯使用终端或需要执行自动化脚本的开发者来说，通过 Git 命令行删除分支是更灵活的方式。删除分支通常需要分两步：先删除本地分支，再删除远程分支。

步骤 1：删除本地分支

在你的本地代码仓库目录中打开终端或命令行工具。

使用以下命令删除本地分支：

安全删除 (-d 或 --delete)： 只删除已合并到当前 HEAD 分支的分支。如果分支包含未合并到 HEAD 的独特提交，此命令会拒绝删除。
bash git branch -d <本地分支名称>
例如，删除本地的 feature/my-new-feature 分支：
bash git branch -d feature/my-new-feature
强制删除 (-D)： 不管分支是否已合并，强制删除该分支。请谨慎使用此命令，因为它可能导致未合并的工作丢失。
bash git branch -D <本地分支名称>
例如，强制删除本地的 experiment/risky-code 分支：
bash git branch -D experiment/risky-code

当你执行删除本地分支的命令时，终端会输出确认信息，例如：

Deleted branch feature/my-new-feature (was abcdef0).

注意： 你不能删除当前你正处于的分支。如果你需要删除当前分支，需要先切换到另一个分支（如 main 或 develop）。

bash git checkout main # 切换到主分支 git branch -d <需要删除的本地分支名称> # 现在可以删除之前的分支了

步骤 2：删除远程分支

删除本地分支只是清理了你本地仓库的引用。通常，你还需要删除 GitLab（远程仓库）上的对应分支。

使用以下命令删除远程分支：

使用 --delete 选项：
bash git push <远程仓库名称> --delete <远程分支名称>
其中 <远程仓库名称> 通常是 origin。 <远程分支名称> 是你在 GitLab 上看到的分支名称。
例如，删除远程的 feature/my-new-feature 分支：
bash git push origin --delete feature/my-new-feature
使用冒号 : 的缩写形式： 这是一个更简洁的语法，表示推送一个空内容到远程分支，从而删除它。
bash git push <远程仓库名称> :<远程分支名称>
例如，删除远程的 feature/my-new-feature 分支：
bash git push origin :feature/my-new-feature

这两种远程删除命令的效果是一样的。执行命令后，终端会显示类似以下信息：

To gitlab.com/your-username/your-project.git - [deleted] feature/my-new-feature

这表示远程分支已成功删除。

步骤 3：清理本地的远程跟踪分支（可选但推荐）

当你通过 Web 界面或命令行删除了远程分支后，你的本地仓库可能还保留着对这个远程分支的“跟踪引用”。例如，你本地可能有一个 origin/feature/my-new-feature 的引用，但远程 origin 上这个分支已经不存在了。这些过时的跟踪引用不会影响你的工作，但会使你的本地仓库信息不那么“干净”。

你可以使用以下命令清理这些过时的远程跟踪分支：

bash git fetch --prune <远程仓库名称>
或者简写为：
bash git fetch -p <远程仓库名称>
通常是：
bash git fetch -p origin

这个命令会下载远程仓库的最新状态，并且移除所有本地不再存在的远程跟踪分支。

执行命令后，终端会显示清理了哪些跟踪分支，例如：

x [deleted] (none) -> origin/feature/my-new-feature

这表示本地对 origin/feature/my-new-feature 的跟踪引用已被移除。

总结命令行删除流程：

通常的流程是：

通过 Web 界面或 Git 命令行 (git push origin --delete <branch>) 删除远程分支。
在你的本地仓库中，通过 git branch -d <branch> 或 git branch -D <branch> 删除本地分支。
运行 git fetch -p origin 清理本地的远程跟踪引用。

如果你是分支的创建者并且确定远程没有其他人基于此分支工作，也可以先删除本地，再删除远程。选择哪种顺序取决于团队的工作习惯和具体情况。

需要注意的重要事项

删除分支是一个不可逆的操作（至少在 Git 的日常使用层面是如此），因此在执行删除前，请务必注意以下几点：

确认分支作用： 在删除任何分支之前，再次确认该分支是否真的不再需要。它是否包含了尚未合并的重要工作？是否是其他开发者正在基于此进行开发的分支？
不要删除重要分支： 切勿删除项目的主分支（如 main、master）或主要的开发分支（如 develop）。这些分支通常是受保护的。
保护分支 (Protected Branches)： GitLab 提供了保护分支的功能，可以防止非授权用户删除或强制推送至特定分支。重要的分支（如 main、develop、release）应该被设置为保护分支。
- 你可以在项目的 Settings (设置) -> Repository (仓库) -> Protected Branches (保护分支) 中配置哪些分支是受保护的以及谁有权限推送或合并到这些分支。
  [图片：GitLab 项目设置中的 Protected Branches 配置页面]
- 受保护的分支无法通过 Web 界面或常规的 Git 命令删除（除非你有特殊的权限，如项目 Owner，并且强制执行，但这是非常危险的操作）。
权限问题： 在 GitLab 中，只有具有足够权限（通常是 Maintainer 或 Owner 角色）的用户才能删除分支，特别是删除非自己创建的分支或受保护的分支。如果你没有删除权限，你需要联系项目管理员。
删除的后果： 删除分支并不会删除分支上的所有提交历史。提交本身仍然存在于仓库中，只要有其他分支或标签引用了这些提交。删除的只是指向分支最新提交的那个“指针”。然而，一旦分支指针被删除，就很难（通过常规手段几乎不可能）再找到这个分支的末端提交并重建分支，除非你明确知道那个提交的哈希值，或者在垃圾回收 (Garbage Collection) 发生之前通过 Git 的 reflog 找到（reflog 只记录本地仓库的操作历史，不涉及远程）。因此，从实用角度来看，删除分支可以认为是永久性的操作。
通知团队： 如果你删除的是一个可能被其他团队成员本地跟踪的分支，最好在删除前或删除后通知团队，以免他们遇到本地分支与远程不同步的问题。他们可能需要在本地运行 git fetch --prune 或手动删除本地跟踪分支。
自动化清理： 对于大型或活跃的项目，可以考虑结合 GitLab CI/CD 或外部脚本，实现自动化清理策略，例如定期删除所有已合并超过 N 天的非受保护分支。但这需要更高级的配置。

总结

保持 GitLab 仓库的整洁有序，是高效协作的基础。删除不再需要的分支是实现这一目标的重要手段。本文详细介绍了两种主要的删除方式：

GitLab Web 界面： 通过仓库的 Branches 页面，点击垃圾桶图标删除单个分支；利用合并请求工作流中的“删除源分支”选项自动或手动删除已合并分支；以及通过过滤功能查找并删除已合并分支（如果可用，使用批量删除按钮）。
Git 命令行： 使用 git branch -d/-D 删除本地分支，使用 git push origin --delete <branch> 或 git push origin :<branch> 删除远程分支，并通过 git fetch --prune origin 清理本地的远程跟踪分支。

无论你选择哪种方式，删除分支前请务必仔细确认，尤其是检查分支的重要性、是否已合并以及是否为受保护分支。通过养成定期清理分支的习惯，你将能更好地管理你的代码仓库，提升团队的协作效率。

希望这篇图文教程能帮助你轻松掌握 GitLab 分支的删除技巧！