Git切换分支需理清工作区状态、HEAD指向和远程跟踪配置：未提交修改冲突会报“ambiguous argument”，应stash或提交；git switch不支持直接切远程分支，需用--track；切后若显示detached状态，说明未切到分支，需用git switch -c新建分支。
Git 切换分支不是“换个名字”就完事，工作区状态、HEAD 指向、远程跟踪配置这三样没理清，git switch 或 git checkout 都会卡住、报错、甚至丢代码。
切换前报 ambiguous argument 错误？检查未提交修改是否冲突
这个错误不是 Git 故意刁难，而是它发现你当前工作区有修改（比如改了 src/utils.js），而目标分支（比如 main）里同一文件在 HEAD 和你本地之间存在内容差异——Git 不敢自动覆盖，就中止切换。
- 先运行
git status看哪些文件是modified或untracked - 如果只是临时搁置，用
git stash push -m "wip: login form"存起来，切完再git stash pop - 如果改得重要且已测试过，直接
git add . && git commit -m "feat: login UI"提交后再切 - 别用
git checkout -f main强制覆盖——-f会无警告丢弃所有未暂存修改
想切到 origin/main 却失败？git switch 默认不认远程分支
git switch origin/main 必然报 fatal: a branch is expected, got remote branch 'origin/main'，因为 git switch 的设计原则就是只操作本地分支指针，不处理远程引用解析。
- 要基于远程分支新建并切换，必须显式加
--track：git switch -c main --track origin/main - 如果只是想临时看一眼远程分支内容（不建本地分支），用
git switch --detach origin/main - 旧脚本里写的
git checkout origin/main是能进分离 HEAD 状态的，但git switch origin/main就不行——这不是 bug，是行为收敛
切完发现文件没变、git status 显示 detached at xxx？你根本没切到分支
执行完 git switch main 或 git checkout main 后，git status 如果显示 HEAD detached at abc1234，说明你当前不在任何本地分支上，而是在某个具体 commit 上。新提交会挂在游离位置，下次切分支就找不到了。
- 立刻运行
git branch：带*的才是当前分支；如果一行都没有，你就处于分离状态 - 用
git log --oneline --decorate --all查HEAD实际指向哪——可能你误输成了git switch abc1234 - 没提交过：用
git switch -回退到上一个分支（短横线是快捷语法） - 已经提交了：先
git switch -c rescue-branch把当前提交救成分支，再考虑rebase或merge进目标分支
最常被忽略的是：CI/CD 脚本里混用 checkout 和 switch。Git 2.23+ 的 switch 对含斜杠的分支名（如 feature/auth/v2）完全安全，但老版本 CI 环境（Git < 2.23）会直接报 command not found。真要升级，得同步确认所有构建节点的 Git 版本，而不是只改一条命令。
