答案是Git的保护机制触发，需根据修改是否保留选择对应操作：①保留则git stash暂存后切分支再git stash pop；②丢弃则git restore .清空工作区；③未跟踪文件需git clean -f或手动移出；④切勿强制--force覆盖。
git switch 报错 “Your local changes would be overwritten” 怎么办
这是最常遇到的阻断型错误，本质是 Git 拒绝用目标分支覆盖你当前未提交的修改。它不是 bug，是保护机制。
常见现象：git switch feature/login 失败，报错末尾带 Your local changes to the following files would be overwritten by switch。
- 先运行
git status确认哪些文件被修改 —— 重点关注 “modified” 和 “untracked” 状态 - 如果这些修改是你需要保留的，用
git stash暂存；切换完成后再git stash pop - 如果只是误改或调试残留，直接
git checkout -- <file></file>丢弃单个文件，或git restore .丢弃全部工作区变更 - 注意：
git stash不会暂存 untracked 文件，加-u参数（git stash -u）才能包含它们
git switch 提示 “ambiguous argument” 或 “did not match any branch”
说明 Git 根本找不到你要切的那个分支名，原因几乎都出在“本地没同步远程信息”或拼写偏差。
典型场景：你在网页上看到别人开了 origin/fix-auth-header，但本地执行 git switch fix-auth-header 就失败。
- 先执行
git fetch origin拉取最新远程分支列表 - 再用
git branch -a查看完整分支名 —— 注意远程分支带remotes/origin/前缀 - 要基于远程分支创建并切换，必须用完整语法：
git switch -c fix-auth-header origin/fix-auth-header - 别依赖 IDE 状态栏显示的“简化分支名”，它可能隐藏了前缀或映射关系
git merge 后卡在 “Unmerged paths”，但没提示冲突文件
这通常是因为 Git 已标记冲突，但某些编辑器或 GUI 工具没高亮显示，或者冲突发生在二进制文件、子模块或 .gitignore 里被忽略的文件上。
- 强制刷新状态：
git status是唯一可信来源，输出里明确列出 “Unmerged paths” 下的文件 - 对每个冲突文件，运行
git diff --name-only --diff-filter=U可快速筛出真正未解决的 - 如果
git status显示冲突但打开文件看不到<<<<<< HEAD标记，可能是该文件被 Git 视为 binary —— 此时需手动比对两个版本，或用git show :2:<file></file>（BASE）、git show :1:<file></file>（HEAD）、git show :3:<file></file>（MERGE_HEAD）提取三方内容 - 别跳过
git add <file></file>—— 即使你删光了冲突标记，Git 仍认为它未解决，直到你显式add
VSCode 里点击分支切换失败，但命令行能切成功
VSCode 的 Git 集成有时会卡在旧状态，尤其在频繁切换、stash/pop 或合并后未彻底刷新时。
- 关闭所有编辑器窗口，重新打开项目根目录（不是子文件夹），让 VSCode 重建 Git 上下文
- 检查 VSCode 右下角状态栏显示的分支名是否和
git branch输出一致 —— 不一致就说明 UI 缓存没更新 - 按
Ctrl+Shift+P打开命令面板，输入 “Git: Refresh” 主动触发重载 - 禁用所有 Git 相关插件（如 GitLens），只留 VSCode 内置 Git，排除干扰
真实项目里最麻烦的从来不是“不会操作”，而是“以为操作成功了”。比如 git switch 返回 success，但工作区文件没变；或 git merge 没报错，却漏掉了某个冲突文件——这种静默异常比明错更耗时间。务必养成每次切换/合并后立刻 git status 看一眼的习惯。
