git reset --hard origin/branch-name 是最常用、最可靠的本地强制同步远程状态方式，但必须先 git fetch origin，否则可能重置到过期快照；若报“pathspec未匹配”，说明本地无该远程跟踪分支引用，需先显式 fetch 分支再执行。
能直接重置，但必须确认远程分支还存在；如果远端已删，git reset --hard origin/branch-name 会报错，不是命令写错了，是引用根本没同步进来。
执行 git reset --hard origin/branch-name 报错 “pathspec 'origin/branch-name' did not match”
这个错误说明本地根本没有 origin/branch-name 这个远程跟踪分支的引用，git reset 找不到目标。常见原因有：
- 远程分支已被删除，且本地未缓存过该引用（
git branch -r | grep branch-name无输出） - 你刚克隆仓库，但没 fetch 过该分支（尤其是非默认分支）
- 执行过
git remote update origin --prune，而远端分支恰好在那次同步前就被删了
解决方法不是反复试 checkout，而是显式 fetch 分支引用：
git fetch origin +refs/heads/branch-name:refs/remotes/origin/branch-name
再运行 git reset --hard origin/branch-name 就能成功。
远程分支还在，但本地想彻底丢弃所有变更并重置
这是最干净的“覆盖式重置”，适用于：本地改乱了、合并冲突没处理完、或想强制对齐远端状态。关键点是：
-
git reset --hard origin/branch-name会清空工作区和暂存区，完全以远程最新提交为准 - 它不拉代码，只重置指针和文件；如果你还担心 submodule 或 LFS 文件没更新，得额外跑
git submodule update --init --recursive或git lfs pull - 如果本地有未推送的 commit，它们会变成游离对象（dangling），
git reflog还能找回，但超过 30 天可能被 GC 清理
远程分支已删，但 PR 页面还能看到最后一次提交 SHA
GitHub/GitLab 的 PR 页面是最后的“冷备份”。只要 PR 没被关闭归档，Commits 标签页顶部显示的完整哈希（如 abc12345678901234567890123456789012345678）就是恢复依据：
- 复制该 SHA（至少前 12 位足够）
- 运行
git branch branch-name abc12345678创建新分支 - 注意别选成 merge commit 的 parent —— PR 页面里最顶上那行才是源分支的 HEAD 提交
- 验证：
git log -1 --oneline应与 PR 中显示的提交信息一致
重置后 VSCode Sync 按钮让一切白干
很多人重置完本地，顺手点了 VSCode 右下角的 Sync，结果远程内容又覆盖回来。这是因为 Sync = git pull + git push 组合，而 pull 会把远端历史重新拉进本地。
- 重置后不要点 Sync，也不要手动
git pull - 如果必须同步其他分支，用
git fetch origin other-branch单独拉取，避免污染当前分支 - 真要推送到远程（比如重置的是
main），必须用git push --force-with-lease origin main，而不是普通 push
真正容易被忽略的是：远端删了、PR 关了、reflog 过期了、连 .git/logs/HEAD 里都找不到线索——这时候只剩 git fsck --lost-found 扫游离对象，但得靠人工比对作者、时间、文件列表，没法靠命令自动识别哪个是你要的那个分支。
