git checkout 不能直接创建新分支，需加 -b 参数；git checkout -b branchname 创建并切换分支，等价于 git branch + git checkout；推荐用 git switch -c 替代。

在 Git 中，git checkout 本身**不能直接创建并切换到一个全新分支**（除非配合 -b 参数）。单独执行 git checkout 新分支名 会报错，因为该分支还不存在。

用 git checkout -b 一步创建并切换

最常用、最直接的方式是使用 -b（branch）选项：

• git checkout -b feature/login：基于当前所在分支，新建名为 feature/login 的分支，并立即切换过去
• 等价于先运行 git branch feature/login，再运行 git checkout feature/login
• 新分支的起始提交点默认是当前 HEAD 所指的提交

指定起始点创建新分支（可选）

如果不想从当前分支创建，而是想从某个特定提交或分支出发：

Convert Github Repository

适用于以下场景：（1）用户提供 GitHub 仓库 URL 或本地仓库路径，并请求将其转换为其他格式；（2）用户请求导出 GitHub 仓库……

下载

• git checkout -b hotfix/bug123 main：从 main 分支最新提交创建并切换到 hotfix/bug123
• git checkout -b experiment abc1234：从指定 commit ID（如 abc1234）创建新分支

注意：现代 Git 推荐用 git switch

自 Git 2.23 起，官方引入了更语义化的命令：

• git switch -c feature/login：功能与 git checkout -b 完全一致，但职责更清晰（专用于分支切换）
• git switch -c bugfix origin/develop：从远程分支 origin/develop 创建本地分支并切换
• 如果你习惯用 checkout，它依然可用；但 switch 和 restore 是未来推荐组合

常见误区提醒

以下写法是错误或有风险的：

• git checkout new-branch → 报错：pathspec 'new-branch' did not match any file(s)（Git 误以为你在检出文件）
• git checkout -b existing-branch → 不报错，但实际是强制重置该已存在分支到当前 HEAD（危险！慎用）
• 忘记 -b 就执行 checkout，容易误操作，建议养成加 -b 或改用 git switch -c 的习惯