git push --set-upstream（或 -u）用于首次推送新分支时建立本地分支与远程分支的追踪关系，否则后续 git pull 或 git push 会因缺少上游配置而报错；它自动设置 branch..remote 和 branch..merge，使后续操作无需重复指定远程分支。
git push --set-upstream 为什么必须加这个参数
不加 --set-upstream（或简写 -u）时，git push 只会把当前分支的提交推到远程，但不会在本地记录「这个分支跟踪哪个远程分支」。后续再执行 git pull 或 git push 就会报错：fatal: The current branch xxx has no upstream branch.
加了 --set-upstream origin/xxx 后，Git 会在本地配置里写入 branch.xxx.remote = origin 和 branch.xxx.merge = refs/heads/xxx，这样后续操作才能自动识别目标。
- 首次推送新分支时，
git push -u origin main是最常用且安全的做法 - 如果远程分支名和本地不一致（比如本地叫
dev，想关联到远程develop），用git push -u origin dev:develop - 别用
git push origin HEAD来替代——它能推上去，但不会设置 upstream，白忙活
已经推过分支，但没设 upstream 怎么补救
常见于直接敲了 git push origin feature/login，结果下次 git pull 报错。这时候不用重推，用 git branch 命令修正跟踪关系即可：
- 确认当前在目标分支上：
git checkout feature/login - 手动设置上游：
git branch --set-upstream-to=origin/feature/login - 验证是否生效：
git branch -vv—— 正常会显示[origin/feature/login]在分支名后面
注意：--set-upstream-to 是 Git 1.8+ 的写法；老版本用 --set-upstream（已弃用），但参数顺序不同，容易写反，建议统一用新版。
生成周报：读取本机 Git 仓库最近一周的提交记录，按项目分类提炼总结，生成标准周报格式，通过微信推送并返回给用户。触发词：周报、weekly report、git总结、提交记录总结、工作周报。
远程仓库地址错了，关联也跟着错怎么办
上游关联本质是绑定「远程名 + 远程分支名」，所以如果 origin 指向了错误的 URL（比如公司内网地址写成 GitHub 地址），即使 upstream 设置对了，git pull 也会连错服务器。
- 先检查远程地址：
git remote get-url origin - 改地址（不删重建）：
git remote set-url origin https://new-server.com/user/repo.git - 改完不需要重新设 upstream —— 只要远程名（
origin）没变，原有跟踪关系依然有效 - 如果远程名本身被改过（比如从
origin改成upstream），就得用git branch --set-upstream-to=upstream/xxx重新指定
多人协作时，别人基于你的分支继续开发，关联会不会冲突
不会。upstream 是纯本地配置，只影响你自己的 git pull/git push 默认行为，不参与 commit、merge 或远程同步逻辑。
- 你设了
feature/a --set-upstream-to=origin/feature/a，别人 clone 仓库后，默认没有这个设置 - 别人可以自己运行
git branch --set-upstream-to=origin/feature/a，也可以不设，直接用git pull origin feature/a - 唯一要注意的是：别在团队文档里写「请务必设 upstream」——这不是协作必需，只是个人效率习惯
真正容易被忽略的是：当远程分支被强制更新（git push --force）或删除后，本地 upstream 不会自动失效，git status 仍可能显示「Your branch is up to date」，但实际已脱节。遇到异常同步行为，优先查 git ls-remote origin 看远程真实状态。
