我的工作常常會使用到 bitbucket 遠端存放庫，前幾次使用不是很熟悉，因此我將步驟記錄下來讓我對 git 語法更熟悉：

將本地專案推送到 Bitbucket 的教學文案

本文介紹了如何將本地的 Git 專案推送到 Bitbucket，包括每個步驟執行指令後的顯示內容。

步驟 1: 初始化本地 Git 儲存庫

如果尚未初始化 Git 儲存庫，首先進入專案目錄並執行以下命令：

1
git init

顯示內容

1
Initialized empty Git repository in /Users/zhuang/iavogue/.git/

步驟 2: 新增 Bitbucket 遠端倉庫

將 Bitbucket 的儲存庫 URL 新增到本地專案的 Git 遠端倉庫列表中：

1
git remote add origin git@bitbucket.org:iambigd/wp-iavogue.git

檢查遠端倉庫是否正確添加：

1
bash
2
git remote -v

顯示內容

1
origin  git@bitbucket.org:iambigd/wp-iavogue.git (fetch)
2
origin  git@bitbucket.org:iambigd/wp-iavogue.git (push)

步驟 3: 添加專案檔案到暫存區

將本地專案中的檔案添加到 Git 暫存區中，準備提交變更：

1
git add .

檢查添加的檔案：

1
git status

顯示內容

1
On branch main
2
Your branch is up-to-date with 'origin/main'.
3
Changes to be committed:
4
  (use "git reset HEAD <file>..." to unstage)
5

6
  new file:   index.html
7
  new file:   styles.css

步驟 4: 提交變更

提交這些檔案並附上提交訊息：

1
git commit -m "第一次提交"

顯示內容

1
[main (root-commit) fd4c3c0] 第一次提交
2
 2 files changed, 190 insertions(+)
3
 create mode 100644 index.html
4
 create mode 100644 styles.css

步驟 5: 推送到遠端 Bitbucket 儲存庫

嘗試將本地專案推送到遠端儲存庫：

1
git push -u origin main

顯示內容（成功時）

1
枚舉物件: 72, 完成.
2
物件計數中: 100% (72/72), 完成.
3
使用 8 個執行緒進行壓縮
4
壓縮物件中: 100% (66/66), 完成.
5
寫入物件中: 100% (71/71), 1.70 MiB | 27.14 MiB/s, 完成.
6
總共 71 (差異 0)，復用 0 (差異 0)，重用包 0 (總共 0)
7
To bitbucket.org:iambigd/wp-iavogue.git
8
   145a286..9a1623a  main -> main
9
Branch 'main' set up to track remote branch 'main' from 'origin'.

常見問題：推送被拒絕 (non-fast-forward)

顯示內容

1
! [rejected]        main -> main (non-fast-forward)
2
錯誤: 推送一些引用到 'bitbucket.org:iambigd/wp-iavogue.git' 失敗
3
提示： 更新被拒絕，因為您目前分支的最新提交落後於其對應的遠端分支。

解決方案

拉取遠端的變更並重新推送：

1
git pull origin main --rebase
2
git push origin main

顯示內容

1
來自 bitbucket.org:iambigd/wp-iavogue
2
 * branch            main       -> FETCH_HEAD
3
成功重定基底並更新 refs/heads/main。
4

5
枚舉物件: 72, 完成.
6
物件計數中: 100% (72/72), 完成.
7
使用 8 個執行緒進行壓縮
8
壓縮物件中: 100% (66/66), 完成.
9
寫入物件中: 100% (71/71), 1.70 MiB | 27.14 MiB/s, 完成.
10
總共 71 (差異 0)，復用 0 (差異 0)，重用包 0 (總共 0)
11
To bitbucket.org:iambigd/wp-iavogue.git
12
   145a286..9a1623a  main -> main

強制推送（如需要）

如果你不在意遠端歷史，或者希望覆蓋遠端的變更，你可以使用 --force 強制推送：

1
git push -f origin main

StackPenguin

將本地專案推送到 Bitbucket 的教學文案

步驟 1: 初始化本地 Git 儲存庫

顯示內容

步驟 2: 新增 Bitbucket 遠端倉庫

顯示內容

步驟 3: 添加專案檔案到暫存區

顯示內容

步驟 4: 提交變更

顯示內容

步驟 5: 推送到遠端 Bitbucket 儲存庫

顯示內容（成功時）

常見問題：推送被拒絕 (non-fast-forward)

顯示內容

解決方案

顯示內容

強制推送（如需要）