错误原因是本地无远程分支跟踪信息，git 不自动拉取；应先 git fetch origin feature/login，再 git checkout -b feature/login origin/feature/login；推荐 git 2.23+ 用 git switch -c feature/login --track origin/feature/login。
git checkout 时提示 “pathspec 'xxx' did not match any file(s)”
这是最常见的误操作：直接 git checkout feature/login，但本地根本没有这个分支的跟踪信息。Git 会先在本地找，找不到就报这个错，而不是自动去远程拉。
正确做法是先让本地知道远程有这个分支，再创建并切换：
- 用
git fetch origin feature/login单独拉取该分支的最新提交（不合并、不切换） - 再执行
git checkout -b feature/login origin/feature/login，创建本地分支并关联到远程对应分支
注意 origin/feature/login 是远程跟踪引用，必须带 origin/ 前缀；漏掉就会报错。
想一步到位：git switch 和 git restore 已替代老命令
Git 2.23+ 推荐用 git switch 替代 git checkout，语义更清晰、容错更强：
-
git switch -c feature/login --track origin/feature/login：创建本地分支并设置上游跟踪 - 如果本地已有同名分支但未跟踪远程，加
-C（大写）强制重置：git switch -C feature/login --track origin/feature/login -
git switch不会意外覆盖工作区文件，比checkout更安全
旧版本 Git（switch，只能用 checkout -b 组合，但逻辑一样——先 fetch 再建立本地分支。
git pull origin branch-name 为什么有时不生效？
git pull origin feature/login 看似简洁，但它只做两件事：fetch + merge（或 rebase）。问题在于，它不会自动创建本地分支，也不会设置 upstream 跟踪关系。
- 如果本地没有
feature/login分支，这条命令会失败（报 “You are not currently on a branch”） - 如果已在其他分支上运行，pull 会把远程分支内容 merge 到当前分支，造成混乱
- 后续
git push或git status都无法识别上游，容易误推错分支
所以除非你明确知道自己在做什么，否则避免直接用 pull 拉新分支。
确认远程分支是否存在且可访问
拉之前最好先验证远程有没有这个分支，尤其在协作项目中分支名可能拼错或已被删除：
-
git ls-remote --heads origin：列出所有远程分支名（不含本地缓存，实时查询） -
git branch -r：列出已知的远程跟踪分支（依赖上次fetch的缓存，可能过期） - 如果
ls-remote里没有，说明分支不存在，或者你没权限访问（私有仓库常见）
别跳过这步——很多“拉不下来”的问题，其实只是分支名输错了，比如 feat/login 写成 feature/login。
