想用远程分支彻底覆盖本地，应执行git fetch + git reset --hard origin/xxx，再按需运行git clean -fd或-fdx；git pull --force已被弃用且行为不可控，无法实现强制同步。
想用远程分支彻底覆盖本地？别用 git pull --force，它早被 Git 官方弃用，行为不可控；真正可靠、跨版本一致的做法只有 git fetch + git reset --hard 两步，再按需补 git clean -fd。
为什么 git pull --force 不能用
Git 2.29+ 已明确标记 --force 参数为“不推荐”，实际行为因版本而异：2.28 之前可能静默忽略，2.30+ 直接报错 fatal: --force not allowed with 'pull'。它既不是强制同步开关，也不跳过冲突逻辑——pull 本质仍是 fetch + merge 或 fetch + rebase，无法绕过本地分支状态校验。
常见错误现象：
- 执行后提示
Already up to date，但本地文件明显旧于远程 - 遇到分叉时仍卡在 merge conflict 提示，加
--force无效 - CI 构建失败后想“重置环境”，结果
pull --force没起作用，还得重来
git reset --hard origin/xxx 会丢掉什么
这个命令不是“覆盖文件”，而是把本地分支的 HEAD、暂存区、工作区三者全部回退到指定提交，并丢弃中间所有变更：
- 所有未
git add的修改（比如改了但没暂存的src/utils.js） - 所有已
git add但未git commit的暂存内容 - 所有已
git commit但尚未git push的本地提交（它们会从分支历史中消失） -
git stash记录本身保留，但后续git stash pop若与重置后代码冲突，仍需手动解决
注意：git reset --hard 不影响未跟踪文件（如 node_modules、dist/、IDE 配置），这些必须靠 git clean 清理。
要不要加 git clean -fd？什么时候加 -x
git clean -fd 不是可选动作，而是“是否需要完全复现 CI 环境”的判断点：
-
git clean -fd：删掉所有未跟踪的文件和目录（比如本地生成的build/、临时日志、新增的测试文件） -
git clean -fdx：额外删除.gitignore中声明忽略的内容（比如你本地node_modules或dist/，但 CI 要求构建前为空） - 如果项目依赖
npm ci或yarn install --frozen-lockfile，且构建脚本假设node_modules不存在，则必须加-x - 执行前务必确认：你不需要保留任何未
git add的产出物，否则删了就真没了
完整安全流程：fetch → reset → clean（按需）
顺序不能错，漏掉 git fetch 就可能重置到过期的远程指针：
- 先确保在目标分支：
git checkout main（或dev、release/1.2） - 获取最新远程信息：
git fetch origin main（只拉该分支，比--all更快更准） - 硬重置：
git reset --hard origin/main - 清理未跟踪项（视场景）：
git clean -fd或git clean -fdx
最后验证：git diff origin/main 应无输出；git status 显示 “Your branch is up to date with 'origin/main'”。真正的风险点不在命令本身，而在执行前没确认当前分支、没检查是否有重要未提交内容、也没判断是否需要 -x —— 这些才是恢复操作中最容易被跳过的步骤。
