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补丁。适用版本见本文说明。