百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT技术 > 正文

Git 实战:一文读懂 git push -u origin main 命令

wptr33 2025-10-19 13:51 2 浏览

简介

命令的完整语法结构

git push -u origin main

其实等价于:

git push --set-upstream origin main

分为三个部分:

部分

含义

git push

推送(push)本地提交到远程仓库

origin

远程仓库名称(默认是 origin,指克隆时的默认远程)

main

要推送的本地分支(同时也是远程分支名)现代 Git 默认分支为 main,早期为 master

-u

建立“跟踪关系(upstream)”,使以后的 push/pull 简化命令

执行时到底发生了什么?

假设你本地有一个分支 main,远程仓库也叫 origin。

执行:

git push -u origin main

输出示例:

枚举对象中: 5, 完成.
对象计数中: 100% (5/5), 完成.
使用 4 个线程进行压缩
压缩对象中: 100% (3/3), 完成.
写入对象中: 100% (5/5), 536 bytes | 536.00 KiB/s, 完成.
总共 5(差异 0),复用 0(差异 0)
To https://github.com/user/repo.git
 * [new branch]      main -> main
分支 'main' 设置为跟踪来自 'origin' 的远程分支 'main'。

设置后的状态

# 再次查看分支信息
git branch -vv
# * main 123abcd [origin/main] 初始提交

Git 内部会做以下几件事:

  1. 推送提交( push commits )
  2. 把本地 main 分支中的提交对象(commit)上传到远程仓库。
  3. 如果远程仓库还没有 main 分支,则会新建一个 main 分支。
  4. 推送分支引用(refs update)
  5. 远程仓库的 refs/heads/main 指向你推送的最新 commit。
  6. 建立 upstream 跟踪关系
  7. Git 会在本地的配置文件 .git/config 中写入类似内容:
  8. [branch "main"] remote = origin merge = refs/heads/main
  9. 这表示:
  10. 你的本地 main 分支的上游(upstream)是远程的 origin/main。
  11. 以后可以直接用 git pull 或 git push(无需再写远程名和分支名)。

底层原理

检查远程仓库:

  • Git 通过 git remote 配置(.git/config 中的 [remote "origin"])获取远程 URL(如 https://github.com/user/repo.git)。
  • 如果未添加远程,使用 git remote add 先添加。

打包和传输对象:

  • Git 扫描本地分支 main 的提交历史,计算需要推送的对象(commits、trees、blobs)。
  • 使用 pack 协议打包对象(压缩后传输),避免传输冗余数据(通过内容寻址的 SHA-1 哈希去重)。
  • 传输到远程仓库的 refs/heads/main(远程分支引用)。

更新远程引用:

  • 远程仓库更新其 main 分支指针,指向最新提交。
  • 如果远程分支不存在,创建新分支。

设置上游跟踪:

  • -u 选项修改本地 .git/config,添加 [branch "main"] 部分:
    • remote = origin:指定远程仓库。
    • merge = refs/heads/main:指定远程分支。
  • 这允许 Git 在后续操作中自动推断上游(如 git status 显示“ahead of origin/main by 2 commits”)。

协议与认证:

  • 默认使用 HTTPS 协议(需输入用户名/密码或 token);SSH 协议(git@github.com:user/repo.git)使用密钥认证。
  • 推送后,Git 更新本地 refs/remotes/origin/main(远程分支的本地镜像)。

后续操作的简化效果

首次推送(需要 -u)

git push -u origin main

建立跟踪关系。

以后推送就可以直接写:

git push

Git 会自动知道推向 origin/main。

拉取也可以直接写:

git pull

Git 会自动从 origin/main 拉取。

常见场景说明

场景

命令

说明

第一次推送新建分支

git push -u origin dev

如果远程没有 dev 分支,会自动创建

已建立跟踪关系后推送

git push

自动推送到上次的远程分支

修改默认远程分支

git branch -u origin/other-branch

改变当前分支的 upstream

查看当前分支的跟踪关系

git branch -vv

显示每个分支的上游分支及状态

取消跟踪关系

git branch --unset-upstream

移除当前分支的 upstream 设置

实际应用场景

场景 1:新仓库首次推送

# 初始化新项目
mkdir my-project
cd my-project
git init
git add .
git commit -m "Initial commit"

# 添加远程仓库
git remote add origin https://github.com/user/repo.git

# 推送并设置跟踪(关键步骤!)
git push -u origin main

场景 2:创建新分支并推送

# 创建并切换到新功能分支
git checkout -b feature/new-feature

# 进行一些开发工作...
git add .
git commit -m "Add new feature"

# 推送新分支并设置上游
git push -u origin feature/new-feature

场景 3:修复分支上游设置

如果分支已经存在但没有设置上游:

# 查看当前分支状态
git status
# 分支基于 'origin/main',但上游信息已丢失。

# 修复上游设置
git push -u origin current-branch-name

相关命令和替代写法

查看配置验证

执行:

git branch -vv

输出示例:

* main  a1b2c3d [origin/main] Initial commit

说明当前分支 main 跟踪远程分支 origin/main。

或者查看配置:

git config --local -l

可以看到类似:

branch.main.remote=origin
branch.main.merge=refs/heads/main

手动设置上游分支(不推送)

# 设置现有分支的上游
git branch --set-upstream-to=origin/main main

不同的分支名称

# 如果默认分支是 master
git push -u origin master

# 推送其他分支
git push -u origin develop
git push -u origin feature/login

与其他参数的区别与组合

命令

作用

git push origin main

只推送,不建立跟踪关系(常用于已存在的远程分支)

git push -u origin main

推送并建立跟踪关系(推荐首次推送使用)

git push --set-upstream origin main

与 -u 等价,更易理解

git push -f origin main

强制推送(慎用,会覆盖远程提交)

git push origin main:remote-name

推送本地 main 到远程的 remote-name 分支

注意事项与常见坑

忘记加 -u 并不是问题

后续可以手动补:

git branch -u origin/main

或者再次使用 git push -u origin main

不同远程仓库可以存在多个(不仅是 origin)

例如:

git remote add backup https://github.com/xxx/backup.git
git push -u backup main

则会在本地配置 branch.main.remote=backup

强制推送谨慎使用

  • 如果使用 -f 或 --force,会覆盖远程历史
  • 建议使用:
git push --force-with-lease

这样会在远程没有被别人改动的情况下才强制。

远程分支删除

git push origin --delete branch_name

相关推荐

Python字符串终极指南!单引号、双引号、三引号区别全解析

导语:Python中字符串(str)是最核心的数据类型!无论你是输出"HelloWorld"还是处理用户数据,都离不开它。今天彻底讲清字符串的三大定义方式及其核心区别,新手必看!...

python 字符串的定义和表示_python字符串的用法

在Python中,字符串是一序列字符的集合。定义一个字符串可以使用单引号或双引号括起来的字符序列。...

简单的python-熟悉字符串相关的操作

str.py:#-*-coding:utf-8-*-#测试函数deff():#字符串使用单引号定义s1='test'print(s...

Python初学者:3招搞定长字符串逐行读取,代码超简单

刚学Python的小伙伴,是不是遇到过这种尴尬情况?拿到一段老长的多行字符串——比如从文档里复制的日志、一段带换行的文章,想一行一行处理,如果直接打印全堆在一起,手动切又怕漏行,咋整啊?别慌!今天就给...

Python 字符串_python字符串型怎么表达

除了数字,Python还可以操作字符串。字符串的形式是单引号('......')双引号(''.........'')或三个单引号(''&...

贴身口语第二关:请求帮忙、道歉、指路、接受礼物

02-@askforhelp请求协助1.F:Excuseme.Canyouhelpme?M:Yes,whatcanIdoforyou?...

NBA赛季盘点之九大装逼&炫技时刻:“歪嘴战神”希罗领衔

欢迎大家来到直播吧NBA赛季盘点,历经许多波折,2019-20赛季耗时整整一年才圆满收官。魔幻的一年里有太多的时刻值得我们去铭记,赛场上更是不乏球员们炫技与宣泄情绪的装逼时刻,本期盘点就让我们来回顾一...

一手TTS-2语音合成模型安装教程及实际使用

语音合成正从云端调用走向本地部署,TTS-2模型作为开源语音生成方案之一,正在被越来越多开发者尝试落地。本篇文章从环境配置到推理调用,详尽拆解TTS-2的安装流程与使用技巧,为语音产品开发者提供...

网友晒出身边的巨人 普通人站一旁秒变“霍比特人”

当巨人遇到霍比特人,结果就是“最萌身高差”。近日网友们晒出了身边的巨人,和他们站在一起,普通人都变成了“霍比特人”。CanYouTellWho'sRelated?TheDutchGiant...

分手后我们还能做朋友吗?_分手后我们还能做朋友吗

Fewrelationshipquestionsareaspolarizingaswhetherornotyoushouldstayfriendswithanex.A...

如何用C语言实现Shellcode Loader

0x01前言之前github找了一个基于go的loader,生成后文件大小6M多,而且细节不够了解,一旦被杀,都不知道改哪里,想来还是要自己写一个loader...

微星Z490如何装Windows10系统以及怎么设 BIOS

小晨儿今天给大家讲一下msi微星Z490重怎样装系统以及怎么设置BIOS。一、安装前的准备工作1、一、安装前的准备工作1、备份硬盘所有重要的文件(注:GPT分区转化MBR分区时数据会丢失)2...

超实用!互联网软件开发人员不可不知的 Git 常用操作命令

在互联网软件开发的协作场景中,Git是不可或缺的版本控制工具。掌握其核心命令,能让代码管理效率大幅提升。本文精选Git高频实用命令,结合场景化说明,助你快速上手。仓库初始化与克隆...

AI项目的持续集成持续部署实践_ai 项目

在独立开发AI工具的过程中,笔者逐步实践了一套高效的软件项目持续集成与持续部署(CI/CD)流程。这套流程以Git、GitHub和Vercel为核心,实现了从代码提交到生产环境上线的全链路自动化。这篇...

总结几个常用的Git命令的使用方法

1、Git的使用越来越广泛现在很多的公司或者机构都在使用Git进行项目和代码的托管,Git有它自身的优势,很多人也喜欢使用Git。...