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 的设计原则就是只操作本地分支指针，不处理远程引用解析。

Git 提交信息生成器

Git 提交信息生成器。根据代码变更内容自动生成符合 Conventional Commits 规范的提交信息，包含类型、范围、简短描述、详细说明和关联的 Issue/需求号。触发词：生成提交信息、提交信息、commit message、git commit、生成 commit 信息

下载

• 要基于远程分支新建并切换，必须显式加 --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