什么是 "git push"？

在 Git 中，git push 是一个核心命令，它用于将本地仓库中的提交推送到远程仓库。

git push 的功能与作用

git push 是 Git 中用于同步本地和远程仓库的命令，其主要功能是将本地分支的最新更改推送到远程仓库。

基本语法：

# 将本地分支推送到远程仓库（创建远程仓库分支）
git push origin <local_branch>:<remote_branch>

# 简写
git push origin <local_branch>

例如：

git push origin main

这会将本地的 `main` 分支推送到名为 `origin` 的远程仓库。默认情况下，如果没有指定远程和分支，`git push` 会推送当前分支到其对应的远程分支。

如何将本地分支推送到远程仓库并设置上游关系？

git push -u

`git push -u` 是用来将本地分支推送到远程仓库并设置上游关系的命令。这样以后你可以直接使用 `git push` 和 `git pull` 命令而不用指定远程分支。

git push -u origin 分支名称

`git push origin main` 和 `git push -u origin main` 的区别在于：

• `git push origin main`：将本地的 `main` 分支推送到远程的 `origin` 仓库，但不设置上游分支。
• `git push -u origin main`：将本地的 `main` 分支推送到远程的 `origin` 仓库，并将其设置为上游分支。之后可以简单地使用 `git push` 和 `git pull` 来推送和拉取。

总结：`-u` 用于建立分支的上游关系。

在 Git 中，上游关系指的是本地分支与远程分支之间的关联。当你设置一个本地分支的上游分支后，Git 会知道从哪个远程分支拉取更新和推送更改。这使得使用 `git push` 和 `git pull` 更加简便，因为你不需要每次都指定远程分支。

以main分支，创建两个一样新的分支：

➜  git-test git:(bb) git checkout main
Switched to branch 'main'
Your branch is up to date with 'origin/main'.
➜  git-test git:(main) git checkout -b test1
Switched to a new branch 'test1'
➜  git-test git:(test1) git checkout main
Switched to branch 'main'
Your branch is up to date with 'origin/main'.
➜  git-test git:(main) git checkout -b test2
Switched to a new branch 'test2'

然后，我们通过命令`git push origin test1` 和 `git push -u origin test2` ，将分支test1 和分支test2推动到远程的`origin`仓库

➜  git-test git:(test2) git push -u origin test2
Total 0 (delta 0), reused 0 (delta 0)
remote: 
remote: Create a pull request for 'test2' on GitHub by visiting:
remote:      https://github.com/lifei-coco/git-test/pull/new/test2
remote: 
To github.com:lifei-coco/git-test.git
 * [new branch]      test2 -> test2
Branch 'test2' set up to track remote branch 'test2' from 'origin'.
➜  git-test git:(test2) git checkout test1
Switched to branch 'test1'
➜  git-test git:(test1) git push origin test1
Total 0 (delta 0), reused 0 (delta 0)
remote: 
remote: Create a pull request for 'test1' on GitHub by visiting:
remote:      https://github.com/lifei-coco/git-test/pull/new/test1
remote: 
To github.com:lifei-coco/git-test.git
 * [new branch]      test1 -> test1

可以看到两条命令的返回信息基本都一样，git push -u origin test2 多了一行返回信息`Branch 'test2' set up to track remote branch 'test2' from 'origin'.`，它表明你已经成功地设置了一个新的分支 test2，该分支被配置为跟踪远程仓库 origin 中的同名远程分支 test2。

通过 git branch -vv 查看上游关系

➜  git-test git:(test1) git branch -vv

  bb    07c367d add index.html
  main  07c367d [origin/main] add index.html
* test1 07c367d add index.html
  test2 07c367d [origin/test2] add index.html

该命令会显示所有本地分支及其对应的上游分支和最新的提交信息，上游分支通常显示在方括号中。

可以看到本地分支test2存在上游分支origin/test2，而本地分支test1是没有上游分支的。

然后，我们向test push新的提交：

➜  git-test git:(test1) touch index2.html
➜  git-test git:(test1) ✗ git status
On branch test1
Untracked files:
  (use "git add <file>..." to include in what will be committed)
    index2.html

nothing added to commit but untracked files present (use "git add" to track)
➜  git-test git:(test1) ✗ git add .
➜  git-test git:(test1) ✗ git status
On branch test1
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
    new file:   index2.html

➜  git-test git:(test1) ✗ git commit -m 'add index2.html'
[test1 90c5c1b] add index2.html
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 index2.html
➜  git-test git:(test1) git push
fatal: The current branch test1 has no upstream branch.
To push the current branch and set the remote as upstream, use

    git push --set-upstream origin test1

会提示我们，当前分支主服务器没有上游分支，推送当前分支并将远程服务器设置为上游。

git push 的工作原理

要理解 git push，需要先了解 Git 的分布式架构。Git 的设计使得每个开发者的本地仓库都是一个完整的代码库副本，包含所有的历史记录、分支和标签。远程仓库则是一个在服务器上托管的代码库副本，通常与团队共享。

git push 的工作原理可以简化为以下几个步骤：

• 选择要推送的分支：通常，用户指定一个本地分支，并将其推送到远程仓库中的相应分支。这个过程可以通过 git push origin branch_name 完成，其中 origin 是远程仓库的默认名称，branch_name 是本地分支的名称。
• 检查远程仓库状态：在推送之前，Git 会检查本地仓库和远程仓库的状态。如果远程仓库中包含尚未在本地合并的提交（例如其他开发者的推送），git push 会失败，提示用户先拉取这些更新。
• 推送提交：如果本地和远程的状态一致或本地分支领先于远程分支，Git 会将所有新的提交从本地推送到远程仓库。推送的过程实际上是在远程仓库中更新分支指针，使其指向本地提交链的最新提交。
• 更新远程引用：一旦提交推送成功，远程仓库的对应分支就会更新为与本地分支相同的状态。这意味着远程分支的指针（通常是 refs/heads/branch_name）指向最新的提交对象。

git push 的使用场景

git push 在日常开发中有多种使用场景，下面列出了一些常见的情况：

• 推送到主分支：通常在功能开发完成且经过代码审查后，开发者会将本地的功能分支合并到主分支（main 或 master），然后使用 git push 将合并后的主分支推送到远程仓库。这一步标志着功能的正式发布。
• 推送到开发分支：在多分支开发模式下，开发者可能会将尚未完成的功能推送到远程的开发分支，以便在其他机器上继续工作或让其他团队成员进行协作。
• 推送标签：在发布版本时，开发者可以创建 Git 标签（tag），并使用 git push origin tag_name 将其推送到远程仓库。标签通常用于标记发布版本，如 v1.0。
• 推送到 Fork 仓库：在开源项目中，贡献者通常会 Fork 原始仓库，并在其副本上进行开发。完成开发后，他们会将更改推送到 Fork 仓库，然后创建 Pull Request 请求将更改合并回原始仓库。

git push 的常见选项与用法

git push 命令有许多选项，适用于不同的场景。以下是一些常见的用法：

• 推送特定分支：git push origin branch_name 将本地 branch_name 分支推送到远程仓库的同名分支。如果远程不存在该分支，则会创建一个新分支。
• 强制推送：git push origin branch_name --force 用于强制推送，即使远程仓库有与本地不同的提交历史。这种操作通常用于覆盖错误的提交记录，但需要谨慎使用，因为它会重写远程仓库的历史。
• 删除远程分支：git push origin --delete branch_name 用于删除远程仓库中的指定分支。这个操作通常在分支合并后进行，以清理不再需要的分支。
• 推送所有分支：git push --all origin 会将本地所有分支推送到远程仓库，确保远程仓库的分支与本地仓库保持一致。

git push 常见问题与注意事项

在使用 git push 时，可能会遇到一些问题或误区，以下是一些常见的情况：

• 推送被拒绝：如果远程分支有尚未被拉取和合并的提交，git push 会被拒绝。此时，你需要使用 git pull 先将远程更改合并到本地，然后再尝试推送。
• 覆盖远程历史：使用 --force 选项时，务必小心，因为它会覆盖远程分支的历史记录，导致其他团队成员无法拉取之前的提交。
• 推送到错误的远程分支：确保在推送前仔细检查命令，以避免意外将代码推送到错误的分支。使用 git remote -v 可以查看远程仓库的详细信息，确保推送到正确的仓库和分支。
• 推送大文件：Git 不适合管理大文件（如二进制文件或大型数据集）。在推送含有大文件的提交时，可能会遇到性能问题或被远程仓库拒绝。因此，最好在 .gitignore 文件中排除大文件，或使用 Git LFS（Large File Storage）来管理这些文件。