适用范围与准备

适用于自己的Git工作区在pull或切换更新时提示local changes would be overwritten。先核对仓库根目录、当前分支和改动归属;共享工作区中别人的改动不能替他们暂存或清理。

先区分原因

pull包含获取远端与后续整合,本地文件与将写入的内容冲突时Git会停止保护工作。换代理只能影响获取链路,不能解决本地内容冲突;reset --hard或clean会破坏你原本想保留的资料。

按顺序操作

  1. 在正确仓库运行只读检查,查看status、未暂存和已暂存差异。若已经处于合并或变基冲突状态,先处理现有操作,不继续套用新的stash和pull步骤。子模块内部改动也要在对应仓库独立检查。
  2. 将重要文件复制到仓库外的独立备份,包含未跟踪和被忽略但需要保留的文件。确认哪些内容确实属于本次工作;本篇不提供批量删除命令。
  3. 需要暂存本人未完成工作时,可运行git stash push -u并加描述。它会保存跟踪文件的改动和未跟踪文件,并从工作区撤回这些内容;默认不收纳被忽略文件,也不是子模块数据的统一备份。
  4. 立即查看stash列表与详情,核对保存的条目和文件确实存在。确认工作区已达到项目允许的更新状态后,按项目指定分支获取和整合;下面的pull --ff-only只允许快进,分支分叉时停止,不自动创造合并或重写历史。
  5. 更新后先检查项目状态,再对已确认的stash条目使用apply。apply保留条目,便于核对;如果出现冲突,停止继续更新,逐文件解决并验证。不要在确认恢复前drop或clear。
目标仓库内只读检查
git rev-parse --show-toplevel
git status --short --branch
git diff --stat
git diff --cached --stat
第一阶段:本人改动已备份后暂存并检查,确认条目正确才继续
git stash push -u -m "before-update"
git stash list
git stash show -u --stat "stash@{0}"
第二阶段:工作区与分支已核对后联网更新;失败时停止
git pull --ff-only
第三阶段:更新成功后,对确认过的本次条目恢复;出现冲突时停止
git stash apply "stash@{0}"

怎样确认有效

确认远端更新落到预期分支,本地工作与仓库外备份相符,未跟踪文件也已恢复;重新检查status并运行项目相关验证。apply默认不保证原来的暂存/未暂存划分完全恢复,应按需要重新暂存。

无效时恢复与下一步

快进被拒绝时保留当前分支和stash,按团队流程处理分叉;apply冲突时条目仍保留,不重复套用或用强制清理消除提示。本文在隔离临时仓库验证冲突、保留与恢复路径,未操作用户工作区或推送远端。