用途:把本地分支推送到 origin(GitHub),在远程初始化该分支,并建立本地与远程分支之间的跟踪关系。适用于新分支需要在 GitHub 上存在、本地分支首次推送、设置远程跟踪,以及用户提出“push branch to origin”或“init branch on GitHub”等请求时。
主要能力与用法:先检查当前状态,运行 git status、git branch --show-current、git remote -v。首次推送并设置上游跟踪使用 git push -u origin <branch-name>,或对当前分支使用 git push -u origin HEAD。推送后可用 git branch -vv 和 git log --oneline --graph --decorate -5 验证远程分支。常见场景包括首次推送当前分支(git push -u origin HEAD)、推送指定分支(git push -u origin feature/my-feature),以及提交后推送(git add .、git commit -m "feat: initial implementation"、git push -u origin HEAD)。
-u 的作用:在本地与远程分支之间建立跟踪,之后可直接使用 git push 和 git pull,并在 git branch -vv 中显示跟踪信息。
最佳实践:首次推送始终使用 -u 设置上游;在初始提交后推送以备份工作;确认分支已出现在 GitHub 上;推送前确保处于正确分支。
限制:资料未提供其他平台支持、权限配置、冲突处理或错误排查等细节。