结论：用 git stash 临时存走本地修改，再拉取/合并，最后 git stash pop 恢复，是最安全、最可控的做法；因为本地未提交修改会与远端变更冲突导致 git 中断操作以防止代码丢失，而 stash 可暂存改动、保持工作区干净，避免强制覆盖或误删风险。
直接说结论：用 git stash 临时存走本地修改，再拉取/合并，最后 git stash pop 恢复，是最安全、最可控的做法。
为什么不能直接 git pull 或 git merge？
当你本地有未提交的修改（git status 显示 modified/untracked 文件），又执行 git pull，Git 会尝试把远端变更“叠加”到你当前工作区。如果远端改了你正在改的同一行，它无法自动合并，就会报错并中断操作——这不是失败，是 Git 在阻止你丢代码。
常见错误现象包括：
error: Your local changes to 'xxx.js' would be overwritten by merge.- 终端卡住，提示 “Please commit your changes or stash them before you merge.”
- 强行加
--force或删文件硬拉，结果本地逻辑全丢
git stash 的实际用法和关键细节
git stash 不是“备份”，而是把当前工作区 + 暂存区的全部改动打包成一个栈顶快照，然后干净地重置到 HEAD 状态。它不产生 commit，也不影响分支历史。
实操建议：
- 先确认状态：
git status看哪些文件被改了，心里有数 - 执行
git stash—— 默认只 stash 已跟踪文件（tracked）；如果还有新增但未git add的文件，加-u参数：git stash -u - 再执行
git pull或git merge origin/main，这时工作区干净，不会冲突 - 合并完后，用
git stash pop把刚才存的修改拿回来；如果有冲突，Git 会明确标出，你只需解决这几处，而不是面对整个 merge 的混乱
注意：git stash pop 是“弹出并删除”，如果想保留 stash 备份以防万一，用 git stash apply（只应用不删除）。
别用 git reset --hard 清掉本地修改
这是新手最容易踩的坑。一旦执行 git reset --hard，所有未提交的修改（包括你刚写的几十行逻辑、调试中的 config）会立刻消失，且无法通过 git reflog 完全恢复——因为这些内容根本没进 Git 对象库。
相比之下，git stash 是有迹可循的：git stash list 能看到所有存档，git stash show -p stash@{0} 可预览内容，安全性高得多。
真正复杂的地方在于：stash 后再 merge，可能出现“二次冲突”——即你本地改的和远端新合入的代码之间有逻辑矛盾。这时候不能只看行级差异，得结合业务意图判断哪边该留。Git 解决不了这个，它只负责把冲突位置标清楚。
