git reset --hard origin/main 会丢掉所有未提交的修改，包括 modified、deleted、renamed 的已跟踪文件及暂存区内容，但保留 untracked 文件；执行前须确认分支、检查 untracked 文件并备份关键数据。
git reset --hard origin/main 会丢掉什么
它会无条件删除所有未提交的修改：包括 git status 显示为 modified、deleted、renamed 的已跟踪文件，以及所有暂存区（git add 过但没 commit）的内容。未跟踪文件（untracked）比如 node_modules/、.env.local、临时日志不会被删，但也不会被“覆盖”——它们原样留在工作区，可能和新代码不兼容。
执行前必须确认的三件事
先运行 git status 看一眼当前状态，重点检查：
- 有没有
untracked files是你手动加的配置或敏感数据（比如数据库密码文件） - 有没有
modified文件是你改了一半但还没提交的逻辑 - 当前分支名是否正确：
git rev-parse --abbrev-ref HEAD，别在dev分支上误重置成origin/main
如果不确定，用 git stash 比硬重置安全；如果确定要清空，至少先备份：cp -r . project_backup_$(date +%s)
标准强制同步流程（无本地 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 时不能直接 reset？
如果你已经 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 自动更新或清理，得靠额外命令补全，漏掉就可能导致构建失败或行为异常
