为何`git rebase upstream/main`在GitHub Actions与本地表现不同？

最常见原因：浅克隆导致历史不完整 #

GitHub Actions默认的actions/checkout会做浅克隆（只拉取最近1次提交），缺少完整的提交历史时，Git没法正确识别文件的溯源关系，rebase时就会把上游的所有修改都当成新添加的内容，和你的本地提交产生add/add冲突。

解决办法：

• 在checkout步骤里加上fetch-depth: 0，拉取完整仓库历史：

- uses: actions/checkout@v4
  with:
    fetch-depth: 0

换行符配置不一致引发的伪冲突 #

本地和GitHub Actions环境的Git换行符处理规则不一样（比如本地用LF，Actions默认可能用CRLF），Git会把换行符的自动转换当成文件修改，导致全量冲突。

解决办法：

1. 在仓库根目录添加.gitattributes文件，统一换行符规则：

* text=auto eol=lf

2. 或者在Actions的脚本里先设置Git换行符配置：

git config --global core.autocrlf false
git config --global core.eol lf

忘记在Actions环境添加上游远程 #

本地已经配置了upstream远程，但GitHub Actions每次都是全新的虚拟环境，默认只有origin远程。如果没先添加上游仓库，git fetch upstream可能无法正常工作，进而引发异常冲突。
在脚本开头加上：

git remote add upstream https://github.com/上游仓库地址.git

Git版本差异导致的逻辑问题 #

旧版本Git在处理rebase时可能存在bug，导致误判冲突。可以在Actions里升级Git到最新版（以Ubuntu环境为例）：

sudo add-apt-repository ppa:git-core/ppa -y
sudo apt update && sudo apt install git -y

内容的提问来源于stack exchange，提问作者theycallmepix