报错“ambiguous argument”是因为未提交修改与目标分支文件冲突，git拒绝自动覆盖；应先用git status查看状态，再stash暂存或提交修改，避免强制切换丢代码。
git checkout 切分支会报错：'ambiguous argument'？
这是因为你当前工作区有未提交的修改，而目标分支里同名文件在 HEAD 和你本地修改之间存在冲突。Git 不敢自动覆盖，就卡住不让你切。
解决办法不是硬加 -f 强制覆盖（容易丢代码），而是先理清状态：
- 用
git status看哪些文件被修改、是否已暂存 - 如果改得不多，用
git stash临时存起来，切完再git stash pop - 如果改得重要又不想暂存，先
git add+git commit提交，再切 - 千万别在没搞清改动前用
git checkout -f branch-name，-f会直接丢弃所有未暂存修改
git switch 比 checkout 更安全，但默认不支持“切到远程分支”
git switch 是 Git 2.23+ 推出的专用分支切换命令，语义更清晰、行为更收敛——它压根不处理文件检出逻辑，只管分支指针移动。
常见误操作是想用它直接切到远程分支，比如：
git switch origin/main
这会报错：fatal: a branch is expected, got remote branch 'origin/main'。因为 git switch 默认只操作本地分支。
- 要基于远程分支新建本地分支并切换，用
git switch -c main --track origin/main - 如果只是想看远程分支内容（不建本地分支），得用
git checkout origin/main或git switch --detach origin/main -
--track参数不能省，否则新建的本地分支不会自动关联远程，后续git push会提示配置 upstream
切换分支后发现文件没变？检查是否处于分离 HEAD 状态
执行 git switch 或 git checkout 后，运行 git status 如果显示 HEAD detached at xxx，说明你没切到分支，而是切到了某个具体 commit 或 tag 上。
这时候所有新提交都会挂在“游离”位置，下次切分支就会丢失。
- 用
git branch确认当前有没有带*的本地分支名 - 用
git log --oneline --decorate --all查看 HEAD 实际指向哪里 - 如果真在分离状态且还没提交，直接
git switch -（短横线）可退回上一个分支 - 如果已提交，先
git switch -c temp-branch把当前提交救成分支，再合并或 rebase 到目标分支
CI/CD 脚本里别混用 checkout 和 switch
很多旧脚本用 git checkout branch-name，升级 Git 后看似能跑，但遇到带斜杠的分支名（如 feature/login-v2）可能出问题：老版本 Git 会把斜杠当路径分隔符，误判为“检出某目录下的文件”。
git switch 没这个问题，它只认分支名；但 CI 环境 Git 版本可能低于 2.23，直接用会失败。
- CI 脚本中优先用
git checkout -B branch-name origin/branch-name（兼容所有 Git 版本） - 如果确定环境 Git ≥ 2.23，用
git switch -c branch-name --track origin/branch-name更明确 - 永远别在脚本里写
git checkout branch-name不带-B或--track，CI 拉不到远程分支时会静默失败
分支切换看着简单，但 HEAD 指针、索引状态、工作区文件三者关系稍一错位，就会触发 Git 的保护机制——它宁可报错也不自动猜你想要什么。所以每次切之前，先 git status 看一眼，比查文档快得多。
