首次推送本地分支到远程仓库必须使用git push -u origin branchname，否则仅单次上传且不建立跟踪关系，后续git pull会报错“no tracking information”。
本地分支第一次推送到远程时，必须显式用 -u 参数才能自动关联；不加就只是单次推送，后续 git pull 和 git push 仍会报错或失败。
git push -u origin branchName 是最直接的初次关联方式
这是新手最容易踩坑也最常被忽略的操作。很多人执行 git push origin main 后以为“已经连上了”，结果下一次 git pull 就报错：There is no tracking information for the current branch.
原因很简单：git push 默认只做上传，不建立跟踪关系；只有加上 -u（即 --set-upstream）才会把本地分支和远程分支“绑死”。
-
git push -u origin main：推送当前分支到origin/main，并设置上游为origin/main -
git push -u origin feature/login：同理，适用于任何本地分支名 - 如果远程仓库还没这个分支，
-u会先创建它，再关联 - 执行完后，
git branch -vv会显示类似* main abc123 [origin/main] commit msg
git checkout --track origin/branchName 适合从远程拉新分支
当你想基于一个已存在的远程分支（比如团队里别人建好的 origin/dev）新建本地开发分支时，别用 git checkout dev —— 它不一定自动跟踪，尤其在 Git 2.29+ 版本中行为更严格。
正确做法是明确告诉 Git：“我要拉这个远程分支，并且立刻跟踪它”：
-
git fetch先同步远程引用（确保你知道origin/dev真的存在） -
git checkout --track origin/dev：创建本地dev分支，并自动设为跟踪origin/dev - 等价写法：
git checkout -b dev --track origin/dev，更显式 - 注意：如果本地已有同名分支，
--track会拒绝覆盖，需先删或换名
git branch --set-upstream-to=origin/branchName 用于补救或重定向
这是“事后补救”的命令，适用场景包括：
- 本地分支已存在，但忘了加
-u，现在想补上 - 原来跟踪的是
origin/old，现在要改成跟踪origin/new - 当前分支名和远程分支名不一致（比如本地叫
feat-login，想跟踪origin/login-ui）
操作示例：
-
git branch --set-upstream-to=origin/main（当前分支） -
git branch --set-upstream-to=origin/login-ui feat-login（指定分支） - 若想解除关联：
git branch --unset-upstream，之后再重新设 - 设完务必用
git branch -vv验证，避免拼错分支名或 remote 名（比如写成orgin/main）
为什么 git checkout branchName 有时能自动关联，有时不能？
这个行为高度依赖 Git 版本和配置，不是稳定可靠的手段。
- Git 1.8–2.28：如果本地无
branchName，且远程有origin/branchName，git checkout branchName会自动创建并跟踪 - Git 2.29+（当前主流版本）：默认关闭该行为，除非设置了
checkout.defaultRemote或启用advice.detachedHead相关提示 - 很多团队禁用自动跟踪，防止误关联错误 remote（比如多个 remote 时）
- 所以别赌运气——要用就明确写
--track，否则就用-u推送
真正容易被忽略的点是：关联只发生在分支层级，不涉及 remote 的 URL 是否可用、SSH 权限是否配置好。哪怕 git remote add origin ... 成功了，git push -u 依然可能因权限失败而没真正建立关联——得看终端最后一行有没有 “Branch ‘xxx’ set up to track remote branch …” 这句确认输出。
