git switch专管分支切换，更安全可控；git checkout兼顾分支与文件操作，易混淆。switch不解析远程引用、拒绝未提交修改时切换、禁用隐式detached head。
直接切分支不报错，不代表代码状态安全——未提交修改、远程差异、工作区污染，三者任一存在都可能让 git switch 或 git checkout 变成“静默灾难”。
怎么确认当前分支和可切换目标？
别凭记忆或 VS Code 状态栏判断分支名，尤其当远程分支名和本地不一致时（比如远程是 origin/main，本地没同步过就不存在 main）。必须用命令实锤：
-
git branch：只看本地分支，星号（*）标出当前所在分支 -
git branch -r：只看远程分支（如origin/develop） -
git branch -a：本地 + 远程全部列出，最可靠
注意：origin/main 是远程引用，不是本地分支；直接 git switch origin/main 会失败。想基于它新建本地分支并切换，得用 git switch -c main --track origin/main。
切换时提示 “your local changes would be overwritten” 怎么办？
这是 Git 在拦你丢代码，不是 bug。它检测到你要切去的分支里有同名文件，而你当前工作区改了但没提交，Git 不知道该保留谁。
- 如果修改还要继续：用
git stash暂存，切完再git stash pop - 如果确定不要这些修改：加
-f强制（git switch -f main），但git checkout -f同样生效，别混用 - 如果想尝试合并修改（极少用）：用
git checkout -m main，但冲突概率高，不如先stash
VS Code 里点“Checkout to…”前，右下角状态栏会显示“Changes”数量，务必点开确认内容——图形界面不会替你做取舍。
git switch 和 git checkout 到底用哪个？
git switch 是 2019 年（v2.23+）起引入的专用分支命令，语义清晰、参数干净；git checkout 是多面手，既能切分支又能恢复文件，容易误操作。
- 切已有本地分支：
git switch main安全，git checkout main也能用但易混淆 - 恢复单个文件（不是切分支）：
git restore file.txt，不是checkout——旧教程里那句“用 checkout 撤销修改”已过时 - 创建并切换：
git switch -c feature/login比git checkout -b feature/login更直白
如果你的 Git 版本低于 2.23（查 git --version），只能用 checkout；否则，switch 是默认推荐，没有兼容性妥协。
远程分支怎么变成可用的本地分支？
远程分支（如 origin/fix/auth）不能直接 switch，必须先让它在本地“落地”。常见错误是手动建空分支再 pull，其实一步到位：
- 自动创建并跟踪：
git switch -c fix/auth --track origin/fix/auth - 如果本地已有同名分支但没跟踪远程：
git branch --set-upstream-to=origin/fix/auth fix/auth - 切过去后立刻同步最新代码：
git pull（前提是已设 upstream）
漏掉 --track 或 --set-upstream-to，后续 git push 或 git pull 就得反复输完整 refspec，这不是省事，是埋雷。
