版本控制与协作 / 系统课时
首次推送本地分支
首次推送本地分支
学习目标
完成本课后,你将能够:
- 将本地提交推送到远程仓库
- 使用 -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 fileTips
- 首次推送推荐显式写出远程和分支,避免推错目标。
- 推送前使用
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再次可用。
按自己的节奏,确认真正理解。