遇到 Git 切换分支报错 error: Your local changes to the following files would be overwritten by checkout 时，最稳妥的做法是先把当前修改保存起来，再切换分支，不要直接使用强制切换命令。
先说结论：这是 Git 的保护机制，防止未提交的修改被覆盖丢失。
- 先确认：使用 git status 查看具体哪些文件被阻挡
- 先处理：通过 stash 暂存或 commit 提交来清理工作区
- 再验证：切换成功后检查分支名和工作区状态
实操解决方案
根据修改是否已完成，选择以下任一方式清理工作区：
方案一：暂存修改（推荐，可恢复）
适合修改未完成，但需要临时切换分支的场景。
git stash
git checkout <目标分支>方案二：提交修改（适合已完成的功能）
适合修改逻辑完整，可以直接提交的场景。
git add .
git commit -m "保存进度"
git checkout <目标分支>方案三：丢弃修改（危险，慎用）
仅当确定本地修改无用时使用，会导致代码丢失且无法恢复。
git checkout -f <目标分支>工作区干净后，也可使用新命令 git switch <分支名> 进行切换。
恢复修改时遇到冲突怎么办
切换回原分支或需要修改的分支后，运行 git stash pop 恢复之前的工作内容。若提示冲突，按以下步骤处理：
- 定位冲突文件：终端会列出冲突文件列表，或使用
git status查看。 - 编辑文件：打开冲突文件，查找
<<<<<<<、=======和>>>>>>>标记。 - 保留代码：
<<<<<<<下方是当前分支内容，=======下方是暂存内容。保留需要的代码，删除所有标记行。 - 提交解决：保存文件后，执行
git add <文件>和git commit完成解决。
验证与常见风险
验证方法：
运行 git branch，确认当前分支前是否有星号标记为目标分支。再次运行 git status，确保没有意外的文件被修改或丢失（除非你选择了丢弃方案）。
常见风险：
- 直接使用
git checkout -f会强制覆盖本地修改，导致代码丢失且无法恢复。 - 暂存栈（stash）是本地独有的，切换远程分支或克隆新仓库时不会携带 stash 内容。
- 使用
git stash pop时可能产生冲突，需要像处理合并冲突一样手动编辑文件。