簡介
命令的完整語法結構
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 內部會做以下幾件事：
-
推送提交（
push commits）- 把本地
main分支中的提交對象（commit）上傳到遠程倉庫。 - 如果遠程倉庫還沒有
main分支，則會新建一個main分支。
- 把本地
-
推送分支引用（
refs update）- 遠程倉庫的
refs/heads/main指向你推送的最新commit。
- 遠程倉庫的
-
建立
upstream跟蹤關係Git會在本地的配置文件.git/config中寫入類似內容：
[branch "main"] remote = origin merge = refs/heads/main-
這表示：
- 你的本地
main分支的上游（upstream）是遠程的origin/main。 - 以後可以直接用
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 pushGit 會自動知道推向 origin/main。
拉取也可以直接寫：
git pullGit 會自動從 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
