版本控制与协作 / 系统课时

首次推送本地分支

首次推送本地分支

学习目标

完成本课后,你将能够:

  • 将本地提交推送到远程仓库
  • 使用 -u 建立上游跟踪关系
  • 判断推送成功后本地与远程分支状态

问题背景或应用场景

本地仓库连接远程后,提交仍只存在于本机。首次推送需要明确指定远程名称和分支,并通常通过 -u 建立上游关系。建立后,Git 才能在不写完整参数时判断当前分支应推送到哪里、应从哪里拉取。

核心原理

git push 会把本地缺失于远程的对象发送过去,并请求更新远程引用。命令 git push -u origin main 表示把本地 main 推送到 origin 上的 main,同时把本地分支的上游设置为 origin/main。

推送不是提交的替代操作。工作区修改必须先提交,推送才会传输相应提交。服务器还可能因为权限、分支保护或非快进更新拒绝请求,因此“本地有提交”并不保证“远程一定接受”。

基础用法

首次推送前依次检查 git status、git log -1 和 git remote -v。执行 git push -u origin main 后,可使用 git branch -vv 或 git for-each-ref 查看上游关系。后续在同一分支可直接使用 git push。

完整可运行示例

以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。

bash
rm -rf git-first-push-demo
mkdir git-first-push-demo
cd git-first-push-demo
git init -q --bare remote.git
git init -q -b main local
git -C local config user.name "Anystack Student"
git -C local config user.email "student@example.com"
printf "ready
" > local/app.txt
git -C local add app.txt
git -C local commit -q -m "feat: add app file"
git -C local remote add origin ../remote.git
git -C local push -q -u origin main
printf "upstream: "
git -C local for-each-ref --format='%(upstream:short)' refs/heads/main
printf "remote-subject: "
git --git-dir=remote.git log -1 --format=%s main

预期输出

text
upstream: origin/main
remote-subject: feat: add app file

Tips

  • 首次推送推荐显式写出远程和分支,避免推错目标。
  • 推送前使用 git status -sb 同时检查分支与领先/落后状态。
  • -u 只需在建立或改变跟踪关系时使用。

常见错误

1. 推送未提交的修改

  • 错误表现:执行推送后服务器没有看到刚编辑的内容。
  • 产生原因:git push 只传输提交,不会上传未提交工作区。
  • 正确处理:先 git add、git commit,再推送。
  • 修复结果:远程分支包含对应提交。

2. 把 -u 理解为强制覆盖

  • 错误表现:担心 -u 会重写远程历史。
  • 产生原因:-u 只是设置上游关系,不等于 --force。
  • 正确处理:正常执行 git push -u origin main,并检查跟踪关系。
  • 修复结果:后续可安全使用简化的 git push。

本课练习

1. 推送功能分支

  • 任务目标:练习非主分支首次推送。
  • 输入或初始条件:创建本地 feature/login 并提交。
  • 实现要求:推送并设置上游。
  • 验收条件:git branch -vv 显示其跟踪 origin/feature/login。

2. 验证远程提交

  • 任务目标:确认推送结果。
  • 输入或初始条件:完成一次推送。
  • 实现要求:直接读取裸仓库或从远程重新克隆。
  • 验收条件:能看到相同提交说明和文件内容。

3. 取消并重设上游

  • 任务目标:理解跟踪配置。
  • 输入或初始条件:当前分支已有上游。
  • 实现要求:取消上游后重新设置到同一远程分支。
  • 验收条件:无参数 git push 再次可用。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

首次推送本地分支

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通