本文介绍如何利用 Bitbucket Cloud 的原生代码搜索功能及 REST API，在一个 Workspace 下的全部仓库中高效定位指定字符串（例如旧版 Maven 依赖 com.mycompany.oldlib），为批量迁移提供精准依据，避免手动克隆数百仓库 grep 的低效操作。
本文介绍如何利用 bitbucket cloud 的原生代码搜索功能及 rest api，在一个 workspace 下的全部仓库中高效定位指定字符串（例如旧版 maven 依赖 `com.mycompany.oldlib`），为批量迁移提供精准依据，避免手动克隆数百仓库 grep 的低效操作。
Bitbucket Cloud（bitbucket.org）原生支持跨仓库代码内容搜索，无需下载代码即可快速定位目标字符串。该能力基于索引化的代码扫描，覆盖所有默认分支（通常为 main 或 master）的文件内容，特别适用于识别分散在多个仓库中的技术债务，如待升级的依赖、硬编码配置或废弃 API 调用。
✅ 推荐方案：使用 Bitbucket Cloud 搜索 API
对于自动化、可复用、可集成的场景，推荐调用官方提供的 Search Code API：
curl -X GET \
"https://api.bitbucket.org/2.0/teams/{workspace}/search/code?q=content:%22com.mycompany.oldlib%22" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Accept: application/json"
- {workspace} 替换为你的团队名（即 URL 中的 https://bitbucket.org/{workspace}/）；
- q=content:"..." 表示在文件内容中精确匹配字符串（支持 Lucene 语法，如 content:"oldlib" AND path:pom.xml 可限定文件类型）；
- 响应返回包含匹配项的仓库名、文件路径、行号及上下文片段，结构清晰，便于后续处理。
⚠️ 注意事项：
- 该 API 仅适用于 Bitbucket Cloud，Bitbucket Server / Data Center 不提供等效的代码搜索 API（仅支持 UI 级搜索）；
- 需要具备 team:read 权限的 OAuth 2.0 Token 或 App Password（建议使用具有最小权限的 App Password）；
- 搜索结果默认分页（pagelen=10），需循环请求 next 字段处理海量结果；
- 索引更新有延迟（通常几分钟内），新提交需稍候才可被搜到。
? UI 辅助验证（所有 Bitbucket 版本均支持）
即使不写脚本，也可通过 Web 界面快速初筛：
- 进入 https://bitbucket.org/{workspace}/ → 点击右上角放大镜图标 → 切换至 “Code” 标签页；
- 输入查询语句，例如：
content:"com.mycompany.oldlib" repo:Projects/Departament
（repo: 支持通配符，如 repo:repo* 或 repo:"repo1|repo2"）； - 结果按仓库分组展示，点击即可跳转至匹配行，适合小范围确认或临时排查。
? 关于“自动替换”的重要提醒
Bitbucket 不提供服务端批量字符串替换功能——这符合 Git 的分布式设计原则：任何代码变更都必须经由本地工作区、提交、推送完成。所谓“一键替换”实际需结合 CI/CD 流水线实现，典型流程为：
- 用上述 API 获取所有含 oldlib 的仓库 + 文件路径；
- 脚本自动 clone 对应仓库 → sed -i 's/com\.mycompany\.oldlib/com\.mycompany\.newlib/g' pom.xml → 提交并推送；
- 触发 PR 或直接推送到特性分支，由人工审核合并。
切勿绕过 Git 工作流直接修改远程仓库对象，否则将破坏历史完整性与协作一致性。
综上，借助 Bitbucket Cloud 的搜索 API，你可在分钟级完成数百仓库的依赖扫描；再辅以轻量脚本，即可构建安全、可审计的批量迁移流水线。
