git切换分支报错“your local changes would be overwritten”是因为工作区存在未提交修改，git为防覆盖而中止操作；解决方式只有两类：保留修改（提交或stash）或丢弃修改（git restore . + git clean -fd）。
git checkout 切分支时提示 error: Your local changes to the following files would be overwritten
这是最常见的情况：工作区有未提交的修改，Git 拒绝直接切换分支，怕覆盖你的改动。它不是“不能切”，而是“不敢替你丢”，得你明确表态。
解决思路只有两个方向：要么保留改动（stash 或提交），要么彻底丢弃（放弃更改）。如果你确定不需要这些修改，最直接的做法是先清理工作区：
- 运行
git checkout .—— 丢弃所有已跟踪文件的本地修改（注意：对新文件、.gitignore 里的文件无效） - 再运行
git clean -fd—— 删除所有未跟踪的文件和目录（-f强制，-d包含目录；务必确认当前目录下没有重要临时文件） - 此时再执行
git checkout <branch-name></branch-name>就能顺利切换
git switch 或 git restore 怎么安全丢弃修改后切分支
Git 2.23+ 推荐用更语义化的命令替代老旧的 git checkout。但要注意：它们职责分离了，不能一招切分支又清改动。
想放弃修改并切分支，得两步走：
- 用
git restore .替代git checkout .，作用一样，但意图更清晰（只恢复工作区） - 用
git clean -fd清理未跟踪项（git restore不处理未跟踪文件） - 再用
git switch <branch-name></branch-name>切换（比git checkout <branch-name></branch-name>更专注分支操作）
⚠️ 注意：git restore -s HEAD . 和 git restore . 效果相同，因为默认源就是 HEAD；加 -s 属于冗余写法，没必要。
为什么 git stash pop 后代码没回来？
有人试过 git stash + git checkout <branch></branch> + git stash pop，结果发现 pop 没还原任何东西，甚至报 No stash entries。
根本原因是：git stash 默认只保存已跟踪文件的修改，不保存未跟踪文件（比如新生成的 log.txt、temp.json）。而 git stash pop 是在目标分支上尝试应用 stash，如果目标分支没有对应文件（比如该文件在原分支才被 add 过），pop 就会静默失败或冲突。
- 若要连未跟踪文件一起暂存，必须显式加
-u：git stash -u - 若还希望暂存忽略文件（如 .idea/），得加
-a：git stash -a（慎用） - 切分支后，用
git stash list确认 stash 是否还在；git stash pop前建议先git stash show -p看内容
放弃更改时最容易误删的三类文件
git checkout . 和 git restore . 都不碰未跟踪文件，但 git clean -fd 会无差别删除。很多人卡在这一步，删掉了本不该丢的东西。
-
node_modules/：前端项目里最大雷区，git clean -fd会直接删光，之后得重新npm install - 编译产物（如
dist/、build/）：如果没进 .gitignore，git clean -fd会删；进了 .gitignore 才安全 - 本地配置文件（如
.env.local、config/dev.yaml）：这类文件通常被忽略，但删了就得手动重填
保险做法是先 git clean -fdn（加 -n 表示 dry-run），看它打算删哪些，确认无误再删。
