git 2.23+ 推荐用 git switch -c 分支名 origin/分支名 创建并跟踪远程分支，旧版本用 git checkout -b；检出前必须先 git fetch origin 同步远程信息。
直接检出远程分支，本质是创建一个本地分支并让它跟踪远程分支。Git 2.23+ 推荐用 git switch，旧版本必须用 git checkout -b；硬切到已有本地分支时用 git checkout 或 git switch 都行，但行为不同——前者会报错提示分支已存在，后者默认拒绝覆盖。
git switch 和 git checkout 的行为差异
Git 2.23 引入 git switch 后，git checkout 被明确标记为“过时但暂未移除”。两者在检出远程分支时的关键区别在于语义和容错：
-
git switch feature：尝试切换到本地已存在的feature分支；若不存在，报错error: no such branch，不会自动创建 -
git switch -c feature origin/feature：显式创建本地feature并设置上游为origin/feature -
git checkout feature：如果本地已有feature，直接切换；如果不存在且远程有origin/feature，Git 会自动创建并跟踪（这是历史遗留的“模糊模式”，容易误触发） -
git checkout -b feature origin/feature：无论本地是否存在，都强制新建并跟踪，行为确定
检出前必须先 fetch 远程分支信息
远程分支名（如 origin/main）只是本地仓库里的一个“指针”，它不会随你敲命令自动更新。不执行 git fetch 就直接 git switch -c dev origin/dev，会报错 fatal: Cannot setup tracking information because remote 'origin' does not have branch 'dev'。
Git Changelog Generator
下载
使用约定式提交（Conventional Commits）从 Git 历史记录中生成结构化变更日志，支持多种格式、AI 增强型描述以及可自定义的范围……
- 最稳妥：运行
git fetch origin（拉取所有远程分支更新） - 想省带宽或只关心某分支：用
git fetch origin dev，但注意这只会更新origin/dev，其他远程分支仍停留在旧状态 - 别用
git pull origin dev替代fetch：它会尝试合并，而你此刻还没本地分支，会失败
远程分支名写错或不存在时的典型错误
常见错误不是语法问题，而是对远程分支命名规则理解偏差：
- 远程分支在本地显示为
remotes/origin/xxx，但实际引用时只需写origin/xxx（remotes/是内部路径，不参与命令） - 执行
git switch -c bugfix origin/bugfix-123报错error: pathspec 'origin/bugfix-123' did not match any file(s)：说明origin/bugfix-123根本没被 fetch 到本地，先查git branch -r | grep bugfix - 看到
origin/heads/xxx？那是旧版 Git 或异常仓库状态，正常应为origin/xxx；遇到这种情况先git remote prune origin清理陈旧引用 - 远程仓库用了非默认远程名（比如
upstream），却仍写origin/xxx：必须用真实远程名，例如git switch -c main upstream/main
检出后如何验证是否正确跟踪
成功检出不等于完成——必须确认本地分支已绑定远程上游，否则后续 git push 或 git pull 会报错或推错地方：
- 运行
git branch -vv，当前分支行末应显示类似[origin/feature] commit message，方括号内是上游分支 - 如果只显示
[no upstream]，说明没跟踪：补上git branch --set-upstream-to=origin/feature feature - 检查配置：
git config --get branch.feature.remote应输出origin，git config --get branch.feature.merge应输出refs/heads/feature - 后续
git pull等价于git pull origin feature，git push默认推送到origin/feature，前提是这些配置存在
最容易被忽略的是：git fetch 不会自动更新你本地已有的远程跟踪分支（比如 origin/main）的提交哈希，除非你显式指定该远程或该分支。很多人以为“刚 pull 过”，就默认 origin/xxx 是最新的，结果检出的其实是几周前的旧快照。
