Bitbucket Pipelines执行git diff origin/master报错，本地Git Bash正常

问题原因 #

Bitbucket Pipelines 默认采用**浅克隆（shallow clone）**策略，只会拉取触发流水线的当前分支代码，不会同步远程仓库的所有分支引用。这就导致origin/master这个远程分支引用在流水线环境中不存在，进而抛出找不到版本的错误。而本地仓库已经拉取了完整的仓库数据，所以该命令能正常运行。

解决方案 #

方案1：显式拉取远程master分支

在执行git diff命令前，先手动拉取远程的master分支，确保流水线环境中存在该分支的引用：

# 拉取远程master分支
git fetch origin master
# 执行原命令获取变更文件
git diff origin/master --name-only

方案2：配置完整克隆

如果需要频繁访问多个远程分支，可以修改bitbucket-pipelines.yml，设置完整克隆仓库，这样流水线会同步所有远程分支的引用，无需额外拉取：

clone:
  depth: full

配置完成后，直接执行git diff origin/master --name-only即可正常运行。

额外提示

如果你的仓库默认主分支已改为main（目前多数代码平台默认主分支为main），请将命令中的master替换为main，避免分支名称不匹配导致的错误。

内容的提问来源于stack exchange，提问作者Sai Teja Makani