如何在Bitbucket项目的所有Git仓库中搜索并替换指定依赖字符串？

一、Bitbucket Server/Data Center 批量搜索方案 #

Bitbucket Server/Data Center提供官方API可实现批量仓库遍历与代码搜索：

1. 获取目标项目下的所有仓库
   调用API获取指定层级（Company/Projects/Departament）项目下的仓库列表，接口示例：

   GET /rest/api/1.0/projects/{projectKey}/repos?limit=1000
   

   其中projectKey对应你的Departament项目标识，返回结果包含每个仓库的slug（短名称）和唯一ID，用于后续操作。

2. 搜索仓库内的目标字符串
   对每个仓库调用代码搜索API，排查是否包含com.mycompany.oldlib：

   POST /rest/search/latest/search
   

   请求体（JSON格式）示例：

   {
     "query": "com.mycompany.oldlib",
     "filters": {
       "repo": "{projectKey}/{repoSlug}"
     },
     "start": 0,
     "limit": 50
   }
   

   返回结果若存在匹配条目，即可标记该仓库为需要修改的目标。

二、批量替换自动化流程 #

定位到目标仓库后，可结合脚本实现全流程自动化：

1. 批量克隆仓库
   通过API获取仓库的HTTPS/SSH克隆地址，用脚本批量克隆到本地临时目录。
2. 执行字符串替换
   在本地用命令行工具或脚本递归替换目标字符串：

   # Linux/macOS环境下递归替换文件内容
   grep -rl "com.mycompany.oldlib" ./ | xargs sed -i '' 's/com.mycompany.oldlib/com.mycompany.newlib/g'
   

3. 提交并推送修改
   脚本自动执行Git操作：git add .、git commit -m "Replace oldlib dependency with newlib"、git push。
4. 清理本地临时文件
   完成推送后删除本地克隆的仓库，释放存储空间。

三、Bitbucket Cloud 操作方案 #

如果使用Bitbucket Cloud：

• 快速搜索：直接在平台搜索栏输入com.mycompany.oldlib，通过筛选器指定目标工作区和项目，即可列出所有包含该字符串的仓库与文件。
• 批量替换：可借助Atlassian ScriptRunner扩展，或编写脚本结合Bitbucket Cloud API完成仓库遍历、修改推送的全流程。

注意事项 #

• 确保API调用使用的令牌/账号拥有仓库的读取、写入权限。
• 先在少量测试仓库验证替换逻辑，避免批量操作引发意外问题。
• 处理大型仓库时，建议分批次执行脚本，避免性能过载。

内容的提问来源于stack exchange，提问作者St.Antario