Git: Git推送与远程同步详解
推送（Push）是将本地提交上传到远程仓库的操作。通过推送，团队成员可以共享代码、同步修改、协作开发。理解推送的各种选项和注意事项对团队协作至关重要。
1. 推送基础概念
(1) 什么是推送
推送是将本地仓库的提交上传到远程仓库的操作：
- 上传提交：将本地的新提交发送到远程
- 更新分支：更新远程分支指针
- 同步代码：让团队成员看到你的修改
- 备份代码：将代码备份到远程仓库
graph LR
A[本地仓库<br/>Local Repository] -->|git push| B[远程仓库<br/>Remote Repository]
B --> C[团队成员<br/>Team Members]
C -->|git pull| D[其他本地仓库]
style A fill:#fff3cd
style B fill:#d4edda
style C fill:#c3e6cb
(2) 推送的前提
推送前需要确保：
- 本地有新的提交（远程没有的）
- 本地分支基于远程分支（没有分叉）
- 有远程仓库的写入权限
- 网络连接正常
(3) 推送的方向
推送是单向操作：本地 → 远程
- 推送不会影响本地仓库
- 推送会更新远程分支
- 推送后团队成员可以拉取更新
2. 基本推送操作
(1) 推送到远程分支
▶ 示例：基本推送
BASH
# 推送当前分支到origin的对应分支
git push
# 输出：
# fatal: The current branch feature has no upstream branch.
# To push the current branch and set the remote as upstream, use
# git push --set-upstream origin feature
# 推送并设置上游分支
git push -u origin feature
# 或者
git push --set-upstream origin feature
# 输出：
# Enumerating objects: 5, done.
# Counting objects: 100% (5/5), done.
# Writing objects: 100% (3/3), 285 bytes | 285.00 KiB/s, done.
# Total 3 (delta 1), reused 0 (delta 0), pack-reused 0
# remote: Resolving deltas: 100% (1/1), completed with 1 local object.
# remote:
# remote: Create a pull request for 'feature' on GitHub by visiting:
# remote: https://github.com/user/repo/pull/new/feature
# To https://github.com/user/repo.git
# * [new branch] feature -> feature
# Branch 'feature' set up to track remote branch 'feature' from 'origin'.
(2) 推送到指定分支
▶ 示例：推送指定分支
BASH
# 推送main分支到origin
git push origin main
# 推送本地分支到远程不同名称的分支
git push origin local-branch:remote-branch
# 推送当前分支到远程main分支
git push origin HEAD:main
# 推送所有本地分支
git push --all origin
# 输出：
# To https://github.com/user/repo.git
# * [new branch] develop -> develop
# * [new branch] feature -> feature
# * [new branch] main -> main
(3) 推送后的验证
▶ 示例：验证推送结果
BASH
# 查看远程分支
git branch -r
# 输出：
# origin/HEAD -> origin/main
# origin/main
# origin/feature
# 查看本地分支的上游设置
git branch -vv
# 输出：
# * main a1b2c3d [origin/main] feat: 添加功能
# feature d4e5f6g [origin/feature] WIP: 新功能
# 查看远程仓库状态
git remote show origin
3. 推送标签
(1) 推送标签到远程
▶ 示例：推送标签
BASH
# 创建标签
git tag v1.0.0
# 推送单个标签
git push origin v1.0.0
# 输出：
# To https://github.com/user/repo.git
# * [new tag] v1.0.0 -> v1.0.0
# 推送所有标签
git push --tags
# 或者
git push origin --tags
# 推送时同时推送标签
git push --follow-tags
# 只推送轻量标签
git push --follow-tags origin main
(2) 删除远程标签
▶ 示例：删除标签
BASH
# 删除本地标签
git tag -d v1.0.0
# 删除远程标签
git push origin --delete v1.0.0
# 或者使用refspec语法
git push origin :refs/tags/v1.0.0
# 输出：
# To https://github.com/user/repo.git
# - [deleted] v1.0.0
(3) 标签推送策略
graph TB
A[创建标签] --> B{标签类型}
B -->|轻量标签| C[不自动推送]
B -->|附注标签| D[推荐推送]
C --> E[手动推送]
D --> F[git push --tags]
style D fill:#d4edda
style F fill:#c3e6cb
4. 强制推送
(1) 什么时候需要强制推送
强制推送用于修改已推送的提交历史：
- 修改了最后一次提交（--amend）
- 使用rebase重写了历史
- 压缩了提交（squash）
- 修复了错误的提交
(2) 使用--force
▶ 示例：强制推送
BASH
# 修改最后一次提交
git commit --amend -m "修正后的提交信息"
# 普通推送会失败
git push origin main
# 输出：
# ! [rejected] main -> main (non-fast-forward)
# error: failed to push some refs to 'https://github.com/user/repo.git'
# 强制推送
git push --force
# 或者
git push -f
# 输出：
# + a1b2c3d...d4e5f6g main -> main (forced update)
(3) 使用--force-with-lease（推荐）
▶ 示例：安全强制推送
BASH
# --force-with-lease 更安全
# 如果远程有其他人推送的新提交，会拒绝推送
git push --force-with-lease
# 输出：
# + a1b2c3d...d4e5f6g main -> main (forced update)
# 如果远程有新提交
git push --force-with-lease
# 输出：
# ! [rejected] main -> main (stale info)
# error: failed to push some refs to 'https://github.com/user/repo.git'
(4) 强制推送的风险
graph TB
A[强制推送] --> B{远程有新提交?}
B -->|有| C[覆盖他人提交<br/>数据丢失]
B -->|无| D[安全更新]
C --> E[团队协作问题]
D --> F[正常工作]
style C fill:#f8d7da
style D fill:#d4edda
⚠️ 重要警告：
- 强制推送可能覆盖团队成员的提交
- 强制推送前先pull确认远程状态
- 优先使用
--force-with-lease - 团队协作中谨慎使用强制推送
5. 推送选项详解
(1) 常用推送选项
| 选项 | 说明 | 使用场景 |
|---|---|---|
-u |
设置上游分支 | 首次推送分支 |
-f |
强制推送 | 修改历史后推送 |
--force-with-lease |
安全强制推送 | 推荐的强制推送方式 |
--all |
推送所有分支 | 批量推送 |
--tags |
推送所有标签 | 发布版本 |
--dry-run |
模拟推送 | 预览推送内容 |
--verbose |
详细输出 | 调试推送 |
▶ 示例：使用推送选项
BASH
# 模拟推送（不实际推送）
git push --dry-run
# 输出：
# To https://github.com/user/repo.git
# * [new branch] feature -> feature
# 详细输出
git push --verbose
# 推送并显示进度
git push --progress
# 推送时跳过钩子
git push --no-verify
(2) 推送配置
▶ 示例：配置推送行为
BASH
# 设置默认推送策略
git config --global push.default simple
# push.default选项：
# nothing - 不推送，必须明确指定
# current - 推送当前分支到同名远程分支
# upstream - 推送当前分支到其上游分支
# simple - 类似upstream，但要求分支名相同（默认）
# matching - 推送所有匹配的分支
# 设置自动设置上游
git config --global push.autoSetupRemote true
# 现在直接git push会自动设置上游
git push
(3) 推送钩子
▶ 示例：推送钩子
BASH
# pre-push钩子在推送前执行
# .git/hooks/pre-push
#!/bin/sh
# 推送前运行测试
npm test
if [ $? -ne 0 ]; then
echo "Tests failed, aborting push"
exit 1
fi
# 跳过钩子推送
git push --no-verify
6. 推送场景与最佳实践
(1) 推送被拒绝的处理
▶ 示例：处理推送拒绝
BASH
# 推送被拒绝
git push origin main
# 输出：
# ! [rejected] main -> main (fetch first)
# error: failed to push some refs to 'https://github.com/user/repo.git'
# hint: Updates were rejected because the remote contains work that you do
# hint: not have locally. This is usually caused by another repository pushing
# hint: to the same ref. You may want to first integrate the remote changes
# hint: (e.g., 'git pull ...') before pushing again.
# 解决方法1：先拉取再推送
git pull --rebase origin main
git push origin main
# 解决方法2：合并后推送
git pull origin main
git push origin main
# 解决方法3：强制推送（谨慎使用）
git push --force-with-lease origin main
(2) 推送工作流
sequenceDiagram
participant 开发者
participant 本地仓库
participant 远程仓库
开发者->>本地仓库: git add & commit
开发者->>远程仓库: git fetch
开发者->>本地仓库: git merge/rebase
开发者->>远程仓库: git push
远程仓库->>开发者: 推送成功
(3) 推送最佳实践
▶ 示例：推送最佳实践
BASH
# 1. 推送前先拉取最新代码
git fetch origin
git rebase origin/main
# 2. 确保提交完整
git status
git log origin/main..HEAD
# 3. 推送到功能分支
git push -u origin feature/user-auth
# 4. 创建Pull Request（在GitHub上）
# 5. 合并后删除远程分支
git push origin --delete feature/user-auth
❓ 常见问题
Q 推送被拒绝怎么办？
A 推送被拒绝通常是因为远程有新的提交。先使用
git pull 或 git fetch + git merge/rebase 同步远程更新，解决可能的冲突后再推送。Q 什么时候需要强制推送？
A 当修改了已推送的提交历史时需要强制推送，例如使用--amend修改提交、使用rebase重写历史、压缩提交等。但要谨慎使用，优先使用--force-with-lease。
Q --force和--force-with-lease有什么区别？
A --force 无条件覆盖远程分支，可能丢失他人的提交。--force-with-lease 会检查远程是否有新的提交，如果有则拒绝推送，更安全。
Q 如何推送新分支？
A 使用
git push -u origin <branch-name> 推送新分支并设置上游分支。之后可以直接使用 git push 推送。Q 推送标签和推送分支有什么区别？
A 推送分支使用
git push origin <branch>，推送标签使用 git push origin <tag> 或 git push --tags 推送所有标签。标签不会随分支自动推送。📖 小节
- 推送是将本地提交上传到远程仓库的操作
- 基本推送：
git push origin <branch>推送到远程分支 - 设置上游：
-u选项设置上游分支，之后可以直接push - 推送标签：
--tags推送所有标签，或单独推送某个标签 - 强制推送：
--force强制覆盖，--force-with-lease更安全 - 推送最佳实践：先拉取再推送，谨慎使用强制推送
📝 作业
-
基础题：创建本地仓库并添加远程仓库，创建提交后推送到远程，体验完整的推送流程，包括设置上游分支。
-
进阶题：模拟推送被拒绝的场景：在远程仓库创建新提交，本地也创建新提交，尝试推送被拒绝，然后使用pull或rebase解决后再推送。
-
挑战题：体验强制推送：使用--amend修改已推送的提交，然后使用--force-with-lease强制推送，理解强制推送的原理和风险。
