Git切换分支时报冲突，本质是Git拒绝覆盖工作区未提交修改以保护数据安全；只要git status显示无modified文件，切换就不会报错。
Git切换分支时出现冲突，本质不是“切换失败”，而是 Git 拒绝覆盖你当前工作区中未提交的修改——它在保护你的本地改动不被意外丢弃。只要工作区干净（git status 显示无未提交变更），git checkout 或 git switch 就不会报冲突。
为什么 git checkout/switch 会提示“error: Your local changes would be overwritten”
这不是合并冲突，而是“文件内容即将被覆盖”的保护性拒绝。Git 发现你要切到的分支里某个文件（比如 build.gradle）和你当前工作区里的同名文件内容不同，而你又没提交或暂存它。
- 常见诱因：改了
app/src/main/AndroidManifest.xml但忘了git add；或者调试时临时注释了某段代码，没清理就去切分支 - 注意：
git status里显示为modified的文件，才是真正的“拦路虎”；untracked文件不影响切换 - 错误做法是直接强制覆盖（如
git checkout -f），这会静默丢弃你所有未保存的修改
三种安全处理方式，按优先级排序
先运行 git status 确认哪些文件被标记为 modified，再决定怎么处理：
-
想保留修改 → 暂存后切分支：
git add+git stash，再git switch；之后用git stash pop恢复 -
确定不要这些修改 → 丢弃单个文件：
git restore（Git 2.23+）或git checkout --（旧版） -
想保留但又不想暂存 → 切换前新建临时分支保存状态：
git checkout -b tmp-save，再切目标分支；后续可git merge tmp-save拿回改动
特别注意 Android Studio 用户的隐藏陷阱
Android Studio 默认启用“Git integration”，但它有时会自动修改 .idea/workspace.xml 或 gradle.properties（比如记录最近打开的模块、JDK 路径），这些文件若被设为 ignored 就不会出现在 git status，但依然会触发切换拒绝。
- 检查是否真有未跟踪的改动：
git status --ignored - 如果确认是 IDE 自动写入且无需版本控制，确保它们已加入
.gitignore，并执行git clean -f -X清理已忽略文件（慎用，先-n预览） - 避免在多人协作项目中把
.idea/提交进仓库——这是最常引发“莫名其妙冲突”的根源之一
真正需要警惕的不是切换时的拒绝提示，而是绕过它强行操作后，发现某次调试加的日志、某个临时改的 API 地址、甚至整个 local.properties 配置全没了。Git 的拒绝，永远比你手动恢复来得快。
