Git合并/变基本地特性分支至更新develop分支时遇异常

首先，针对你遇到的两个迷惑性错误，我们先拆解背后可能的原因，再给出后续的预防方案：

一、为什么明明工作区干净，却出现这些错误？ #

你碰到的情况大概率是Git索引（暂存区）与HEAD状态不一致，或是一些容易被忽略的隐式变更导致的：

1. 索引残留变更：有时候执行git add后用git reset HEAD <file>撤销，但部分文件的索引状态没完全同步到工作区——这时git status显示工作区干净，但git diff --cached能看到索引里的残留变更，直接触发合并/变基的错误提示。
2. 换行符自动转换冲突：如果你的Git配置了core.autocrlf=true，不同分支可能因换行符处理逻辑差异（比如feature分支用LF、dev分支用CRLF），导致Git把换行符转换后的文件标记为“已修改”，但肉眼完全看不出工作区有变化。
3. 文件权限变更：Git默认会跟踪文件权限的变更（比如从只读644变为可执行755），这类变更很难被肉眼察觉，但会被Git识别为“未暂存变更”。
4. 忽略文件被意外跟踪：如果gulpfile.js、package-lock.json这类文件本来在.gitignore里，但之前误执行了git add，后续分支变更时就会出现冲突误报。

二、当时可以怎么排查和解决？ #

如果再遇到类似情况，可以按以下步骤快速处理：

• 检查索引状态：执行git diff --cached，查看是否有暂存区的残留变更。如果有，执行git reset HEAD .将索引重置为HEAD状态，再重新尝试合并/变基。
• 排查隐式变更：执行git diff，看是否有换行符或权限的变更。如果是换行符问题，可以临时关闭自动转换：git config core.autocrlf false，处理完后再改回原配置；如果是权限问题，可以执行git config core.filemode false让Git忽略权限变更。
• 强制以feature分支为准合并：如果确认要让feature分支的文件覆盖dev分支版本，直接执行git checkout feature-branch -- gulpfile.js package-lock.json package.json，把这些文件从feature分支拉到dev分支，提交后再完成合并即可。

三、后续避免此类问题的建议 #

• 切换分支前同步状态：每次切换分支前，执行git reset HEAD . && git checkout .，确保索引和工作区完全匹配当前HEAD的状态。
• 统一团队Git配置：和团队成员统一core.autocrlf和core.filemode的配置，避免环境差异导致的隐式变更。比如推荐Windows用户设core.autocrlf=true，Linux/macOS用户设core.autocrlf=input，但要保持团队内一致。
• 操作前拉取最新远程分支：在合并/变基前，确保本地dev分支已经拉取并合并了origin/dev的最新变更，同时feature-branch没有未提交的本地变更（你已经做到这一点，可以固化为操作习惯）。
• 用git stash兜底：如果碰到莫名其妙的“未暂存变更”提示，先执行git stash push -m "temp stash"暂存所有内容（哪怕git status显示干净，这一步也能触发Git同步状态），再执行git stash pop，很多时候能解决索引和工作区的不一致问题。

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