Git Rebase 之后出现大量未暂存文件的问题与解决方案

前言

最近在使用 git pull --rebase 同步代码时，遇到了一个棘手的问题：rebase 完成后，Git 显示有 24976 个未暂存文件，但实际上这些文件并没有任何改动。本文记录问题的排查过程和解决方案。

问题描述

场景复现

1. 执行 git push 推送代码时被拒绝（non-fast-forward）

2. 按提示执行 git pull --rebase origin feature/develop

3. 解决了一个文件的合并冲突，完成 rebase

4. 发现 Git 显示大量文件处于"未暂存"状态

   $ git status
   未暂存文件 (24976 文件)
   VideoReceiverApp/android/gradle/wrapper/gradle-wrapper.properties
   VideoReceiverApp/android/res/drawable-hdpi/icon.png
   VideoReceiverApp/android/res/drawable-ldpi/icon.png
   ...

问题特征

• 文件数量巨大（上万个）
• 主要是二进制文件（.png、.jar、.jpg）和配置文件
• 文件内容实际上没有任何改动
• 使用 git diff 查看也没有显示实际差异

原因分析

1. 子模块状态不一致（最常见）

项目中如果包含 Git 子模块（submodule），rebase 操作可能导致子模块的引用指针与实际状态不一致，从而显示大量"变更"。

2. 换行符问题（CRLF/LF）

Windows 和 Linux/Mac 使用不同的换行符，rebase 过程中可能触发换行符转换。

3. 文件权限变化

rebase 可能改变文件的执行权限，Git 会将其识别为修改。

---

✅ 实际解决方案（亲测有效）

第一步：重置到远程状态

# 强制重置到远程分支（最干净的方式）
git fetch origin
git reset --hard origin/feature/develop

# 更新子模块
git submodule update --init --recursive

这是最彻底、最有效的方式，直接将本地分支状态完全同步到远程。

第二步：如果还有未暂存文件

可能是 .gitattributes 或换行符问题，设置：

git config --global core.autocrlf true
git rm --cached -r .
git reset --hard

---

⚠️ 预防措施：避免 Rebase 问题

用 merge 代替 rebase

# ✅ 拉取时用 merge（默认方式，推荐）
git pull origin feature/develop

# ❌ 避免使用 rebase
git pull --rebase origin feature/develop

Rebase vs Merge 对比

特性	Rebase	Merge
提交历史	线性整洁	保留分支结构
冲突处理	可能需要多次解决	一次性解决
子模块兼容性	❌ 容易出问题	✅ 更稳定
团队协作	不推荐共享分支使用	✅ 推荐

---

其他解决方案（备选）

方案一：硬重置到 HEAD

git reset --hard HEAD

方案二：使用 checkout 恢复

git checkout .
# 或
git restore .

方案三：清理未跟踪文件

git clean -fd

⚠️ 注意：会删除未跟踪的文件，请确保没有重要的新文件。

方案四：取消正在进行的 Rebase

# 正在 rebase 中时
git rebase --abort

# 已完成但想回退
git reflog
git reset --hard HEAD@{n}

---

命令速查表

# ===== 核心解决方案 =====
git fetch origin
git reset --hard origin/feature/develop
git submodule update --init --recursive

# ===== 换行符问题 =====
git config --global core.autocrlf true
git rm --cached -r .
git reset --hard

# ===== 其他常用命令 =====
git checkout .                    # 撤销未暂存更改
git restore .                     # 同上（新版 Git）
git reset --hard HEAD             # 重置到当前 HEAD
git rebase --abort                # 取消 rebase
git clean -fd                     # 清理未跟踪文件
git reflog                        # 查看操作历史
git submodule status              # 检查子模块状态

总结

Git rebase 后出现大量未暂存文件，主要原因是子模块状态不一致。

最佳解决方案：

git fetch origin
git reset --hard origin/branch-name
git submodule update --init --recursive

预防建议 ：团队协作中优先使用 git pull（merge）而非 git pull --rebase。