gitlab批量删除远程分支(推荐方案二)

若需批量删除GitLab远程服务器上 特定代码库（项目）的多余分支，可通过以下方案实现。以下方法均需先确认项目ID（可在项目URL中查看，如 https://gitlab.com/group/project对应的ID通常为数字，也可通过API查询）。

方案一：通过GitLab API批量删除（推荐）

使用Python脚本调用GitLab API，可精确筛选并删除符合条件的分支。以下是示例代码：

import requests
import json# 配置信息
GITLAB_URL = "https://your-gitlab.com"  # 替换为你的GitLab域名
PRIVATE_TOKEN = "your_access_token"      # 替换为你的Access Token（需有项目维护者权限）
PROJECT_ID = 1234                        # 替换为目标项目ID# 获取项目所有分支
def get_project_branches():headers = {"PRIVATE-TOKEN": PRIVATE_TOKEN}url = f"{GITLAB_URL}/api/v4/projects/{PROJECT_ID}/repository/branches"branches = []page = 1while True:response = requests.get(url, headers=headers, params={"page": page, "per_page": 100})if response.status_code != 200:raise Exception(f"获取分支失败: {response.text}")current_page = response.json()if not current_page:breakbranches.extend(current_page)page += 1return branches# 删除分支
def delete_branch(branch_name):headers = {"PRIVATE-TOKEN": PRIVATE_TOKEN}url = f"{GITLAB_URL}/api/v4/projects/{PROJECT_ID}/repository/branches/{branch_name}"response = requests.delete(url, headers=headers)if response.status_code == 204:print(f"成功删除分支: {branch_name}")else:print(f"删除失败 {branch_name}: {response.text}")# 主函数：筛选并删除符合条件的分支
def main():branches = get_project_branches()protected_branches = ["main", "master", "develop"]  # 保护这些分支，不删除for branch in branches:branch_name = branch["name"]# 跳过保护的分支if branch_name in protected_branches:continue# 跳过受保护的分支（根据GitLab设置）if branch.get("protected", False):continue# 示例：删除所有以feature/或temp-开头的分支if branch_name.startswith("feature/") or branch_name.startswith("temp-"):delete_branch(branch_name)if __name__ == "__main__":main()

使用步骤：

1. 在GitLab中生成Personal Access Token（Profile Settings > Access Tokens，勾选api权限）；
2. 修改脚本中的GITLAB_URL、PRIVATE_TOKEN、PROJECT_ID；
3. 根据需求调整筛选条件（如修改protected_branches或分支名称匹配规则）；
4. 执行脚本：python delete_branches.py。

方案二：通过Git命令批量删除（本地操作）

在本地克隆项目后，通过Git命令批量删除远程分支：

1. 克隆项目并切换到目标分支

git clone git@your-gitlab.com:group/project.git
cd project

2. 筛选需要删除的分支

# 获取所有远程分支（排除保护分支）
git branch -r | grep -v 'origin/main\|origin/master\|origin/develop' > branches-to-delete.txt# 编辑branches-to-delete.txt，删除不想删除的分支
vim branches-to-delete.txt

3. 批量删除远程分支

# 方式一：使用xargs（需手动确认）
cat branches-to-delete.txt | sed 's/origin\///' | xargs -I{} git push origin --delete {}# 方式二：生成删除命令脚本（更安全）
cat branches-to-delete.txt | sed 's/origin\///' | awk '{print "git push origin --delete " $1}' > delete-branches.sh# 检查生成的脚本，确认无误后执行
bash delete-branches.sh

方案三：按条件筛选删除（高级）

根据不同场景，可使用更精确的筛选条件：

1. 删除已合并到main的分支

# 获取所有已合并到main的分支（排除保护分支）
git branch -r --merged origin/main | grep -v 'origin/main\|origin/master\|origin/develop' > merged-branches.txt# 批量删除
cat merged-branches.txt | sed 's/origin\///' | xargs -I{} git push origin --delete {}

2. 删除3个月前未更新的分支

# 获取3个月前未更新的分支（需安装dateutils）
git for-each-ref --sort='-committerdate' --format='%(committerdate:iso8601) %(refname:short)' refs/remotes/origin | \awk '$1 < "2023-04-01" {print $2}' | \grep -v 'origin/main\|origin/master\|origin/develop' > old-branches.txt# 批量删除
cat old-branches.txt | sed 's/origin\///' | xargs -I{} git push origin --delete {}

注意事项

1. 备份数据：删除前建议通过GitLab UI导出项目（Settings > General > Advanced > Export project）。
2. 保护核心分支：确保排除main、master等重要分支，避免误删。
3. 权限验证：确认你的GitLab账号有删除分支的权限（至少是项目维护者角色）。
4. 分批执行：若需删除大量分支（如超过1000个），建议分批执行，避免触发API限流或数据库压力过大。
5. 监控服务器性能：大规模删除时，通过GitLab监控页面观察服务器资源使用情况，避免影响正常服务。

验证删除结果

删除后，可通过以下方式验证：

• 在GitLab UI中查看项目的分支列表（Repository > Branches）；
• 执行git fetch --prune更新本地分支引用，查看是否已删除；
• 通过API再次查询分支列表确认：

  curl --header "PRIVATE-TOKEN: your_token" "https://your-gitlab.com/api/v4/projects/1234/repository/branches"
  

通过以上方法，可安全高效地清理特定项目中的冗余分支，提升GitLab性能。