拉取Laravel 5外部分支时vendor目录冲突问题求助

兄弟，你遇到的这个问题我之前帮好几个Laravel开发者排查过，本质上就是仓库历史里意外提交了/vendor目录下的文件，哪怕你本地的.gitignore已经排除了它，但远程分支里这些文件是被Git追踪的，所以拉取时直接撞车了。给你拆解细节：

1. Git Ignore的局限性：你的.gitignore配置没问题，但这个规则只对未被Git追踪的文件生效。如果有人之前不小心把vendor/composer/autoload_static.php这类文件提交到了远程仓库，Git就会一直把它们当成仓库的一部分，ignore规则完全管不住。
2. 冲突的具体原因：
   • error: refusing to lose untracked file at 'vendor/composer/autoload_static.php'：你本地的/vendor是未被追踪的文件，但拉取的外部分支里有这个文件的修改/删除记录，Git怕你丢失本地数据，所以直接拒绝操作。
   • CONFLICT (modify/delete)：你的本地HEAD分支已经删除了autoload_real.php，但你要拉取的提交b871903544566b6c1fd662ac67e7987f1ecc8643里修改了这个文件，Git没法自动判断该留哪一个，就把远程版本留在本地了。
3. 你说得太对了！手动修改/vendor里的文件完全没有意义——这个目录是Composer自动生成的，所有文件都是依赖包的自动加载逻辑，手动改完之后，下次执行composer install或composer update就会被直接覆盖，纯粹做无用功。

第一步：备份本地重要文件（可选但推荐） #

虽然/vendor是自动生成的，但如果你本地临时改了一些东西（非常不建议这么做），可以先把整个/vendor目录复制到项目外的地方备份，避免误删丢失。

第二步：清理本地未追踪的/vendor文件 #

现在本地的/vendor是未被Git追踪的，先把它删掉，让本地状态和远程分支的追踪文件对齐：

# Mac/Linux用户
rm -rf vendor/

# Windows PowerShell用户
Remove-Item -Recurse -Force vendor/

第三步：解决拉取冲突 #

现在本地没有/vendor的干扰文件了，重新拉取外部分支。如果还是出现冲突，可以用以下两种方式处理：

方式1：直接采用远程分支的版本（推荐） #

如果你不需要保留本地对这些追踪文件的修改，直接让Git优先使用远程分支的版本：

git pull <远程仓库名> <分支名> --strategy-option theirs

比如远程仓库名是origin，分支是develop，就是：

git pull origin develop --strategy-option theirs

方式2：暂存本地修改后再拉取（不推荐，除非你有必须保留的修改） #

如果本地确实有需要保留的修改（再次强调：/vendor里的修改不建议保留），可以先暂存，拉取后再合并：

# 暂存本地所有修改
git stash

# 拉取远程分支
git pull <远程仓库名> <分支名>

# 恢复暂存的修改（如果有冲突需要手动解决）
git stash pop

第四步：彻底修复仓库（防止以后再出问题） #

拉取完成后，一定要把远程分支里的/vendor目录从Git追踪中移除，这样以后所有协作者都不会再遇到这个问题：

1. 确保你当前在目标分支上，且代码是最新的：

git checkout <分支名>
git pull

2. 移除/vendor目录的Git追踪，但保留本地的/vendor文件（因为我们还要用Composer生成）：

git rm -r --cached vendor/

3. 提交这个修改：

git commit -m "Stop tracking vendor directory (fix git ignore issue)"

4. 推送到远程仓库：

git push <远程仓库名> <分支名>

最后：重新生成/vendor目录 #

不管之前怎么操作，最后都要用Composer重新生成标准的/vendor目录：

composer install

这样生成的文件都是符合Laravel和Composer规范的，不会有任何问题。

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