Git拉取被本地修改阻止:先保留差异再发布

适用范围:自己管理的Git部署目录;生产运行目录不要直接stash或切分支试错。

拉取代码被“local changes would be overwritten”挡住,说明工作目录里的变化不能被这次更新直接覆盖。不要急着执行reset --hard或clean。那些文件可能包含线上热修复、环境配置,甚至误放在项目中的客户上传。

先只读查看变化类型

git status --short
git branch --show-current
git diff --stat
git diff --cached --stat
git ls-files --others --exclude-standard

在当前项目目录执行。区分未暂存修改、已暂存修改、未跟踪文件,以及被忽略但仍需保留的配置。status显示干净,也不代表上传目录和数据库已经备份。[1]

把差异保存到受控位置

下面仅导出差异,不清理工作区:

(
  umask 077
  work=$(mktemp -d) || exit 1
  git diff --binary > "$work/unstaged.patch" || exit 1
  git diff --cached --binary > "$work/staged.patch" || exit 1
  printf '差异保存目录:%s\n' "$work"
)

补丁可能包含密钥或客户信息,不能公开。两份补丁不包含所有未跟踪、忽略文件和业务数据,仍需按清单单独备份。这不是完整站点备份。

不在正在服务的目录里清空修改

stash会把选择的工作区内容移走,生产应用可能马上读到不同文件。它适合开发工作区暂存,不是在线发布的自动回退方案。包含未跟踪文件的选项也会改变范围,不能盲目加上。[2]

更稳妥的路径是:保留当前运行目录,在新的构建目录准备目标提交;把需要保留的修改经过评审合并,把环境配置和上传数据按既定方式外置,再构建和测试。确认通过后才切换发布指向。

判断本地修改属于哪一种

代码修复应进入版本控制,不长期只留在服务器。运行时配置应有独立管理方式,密钥不能随代码提交。程序自动生成的日志、缓存和上传文件应移出代码更新覆盖范围,不能只为了让pull成功就删除。

如果变化来自不明账号或异常程序,先保留证据并排查来源,不直接把它提交到远程仓库。

发布与回退验收

记录目标提交、构建产物、环境配置和数据库变更。新版本不仅要启动,还要验证关键业务;旧版本目录和必要依赖保留用于回退。数据库迁移不能仅靠切回旧代码恢复,须单独评估兼容性。

确认所有本地差异已被保留或明确放弃后,才整理旧工作区。不要把“pull成功”当作发布成功。

继续排查

网站迁移前的备份与恢复演练;Docker应用更新失败,怎样退回原来的版本。

技术依据:[1] Git status与工作区状态;[2] Git stash行为;[3] Git diff与binary补丁。适用版本见本文说明。