git reset --hard origin/main会丢弃所有已跟踪文件的本地修改（含modified、deleted、renamed及已add未commit内容），但保留untracked文件；执行前须确认git status无敏感未跟踪文件、无半成品代码，并核实当前分支。
git reset --hard origin/main 会丢掉什么
它会无条件清空工作区和暂存区所有已跟踪文件的修改：包括 modified、deleted、renamed 状态的文件，以及所有 git add 过但未 commit 的内容。但 untracked 文件（比如 .env.local、node_modules/、临时日志）原封不动留在磁盘上——它们既不会被覆盖，也不会自动适配新代码逻辑，容易引发运行时错误。
执行前必须确认的三件事
别跳过这三步，否则可能删掉关键配置或半成品逻辑：
- 运行
git status，重点看有没有Untracked files是你手动加的敏感数据（如数据库密码） - 检查
modified文件里是否有还没提交但已写了一半的功能代码 - 用
git rev-parse --abbrev-ref HEAD确认当前分支名，避免在dev分支上误重置成origin/main
标准强制同步流程（无本地 commit 场景）
这是最常用也最稳妥的操作链，适用于只改了文件但没 commit 的情况：
-
git fetch --all：拉取所有远程分支最新 ref，确保本地知道origin/main当前指向哪个 commit -
git reset --hard origin/main：把当前分支HEAD、暂存区、工作区全部重置到远程main最新 commit -
git clean -n：预览将被删除的未跟踪文件（如编译产物、临时生成文件），确认无误再执行下一步 -
git clean -fd：真正清理，注意不加-n直接跑是危险的 - 子模块需单独处理：
git submodule update --init --recursive，否则git status会显示子模块路径为modified却看不出变化
有本地 commit 时怎么安全重置
如果你已经 git commit 但没 push，git reset --hard origin/main 依然有效——它会直接抹除那些本地 commit，Git 不会警告“你有 3 个 commit 即将丢失”，而是静默执行。
但要注意：
- 想保留 commit 记录又同步远端代码，该用
git pull --rebase，不是强行覆盖 - 如果本地 commit 已被别人基于开发（比如 CI 构建过），重置后推送要用
git push --force-with-lease，且必须提前git fetch更新本地 remote ref 缓存 - 真正容易被忽略的是子模块和未跟踪文件：它们不会随
reset --hard自动更新或清理，漏掉就可能导致构建失败或行为异常
