Windows 安裝#

1. 前往 git-scm.com 下載
2. 一路 Next（預設選項即可）
3. 安裝完成後，打開 Git Bash 或 PowerShell

macOS 安裝#

1
# 使用 Homebrew
2
brew install git

Linux 安裝#

1
# Ubuntu/Debian
2
sudo apt install git
3

4
# Fedora
5
sudo dnf install git

初次設定（必做！）#

安裝完成後，設定你的身份：

1
git config --global user.name "你的名字"
2
git config --global user.email "你的email@example.com"

💡 這個 email 建議用你的 GitHub 帳號 email，這樣 commit 才會正確連結到你的帳號。

核心概念圖#

1
工作目錄 (Working Directory)
2
    ↓ git add
3
暫存區 (Staging Area)
4
    ↓ git commit
5
本地儲存庫 (Local Repository)
6
    ↓ git push
7
遠端儲存庫 (Remote Repository - GitHub)

建立新專案#

1
# 方法 1：在現有資料夾初始化
2
cd 你的專案資料夾
3
git init
4

5
# 方法 2：從 GitHub 複製現有專案
6
git clone https://github.com/使用者/專案名.git

日常三連發：add → commit → push#

這是你每天會用到的三個指令：

1
# 1. 查看目前狀態（養成好習慣，每次操作前先看一下）
2
git status
3

4
# 2. 將修改加入暫存區
5
git add .                    # 加入所有修改
6
git add 檔案名稱             # 只加入特定檔案
7

8
# 3. 提交到本地儲存庫
9
git commit -m "簡短描述這次修改"
10

11
# 4. 推送到 GitHub
12
git push origin main

查看歷史紀錄#

1
# 查看提交紀錄
2
git log --oneline
3

4
# 輸出範例：
5
# a1b2c3d (HEAD -> main) 新增登入功能
6
# e4f5g6h 修正首頁排版
7
# i7j8k9l 初始化專案

分支基礎操作#

1
# 查看所有分支
2
git branch
3

4
# 建立新分支
5
git branch feature-login
6

7
# 切換到該分支
8
git checkout feature-login
9

10
# 建立 + 切換（一步到位）
11
git checkout -b feature-login

合併分支#

開發完成後，把分支合併回主線：

1
# 1. 先切回 main
2
git checkout main
3

4
# 2. 合併 feature-login 到 main
5
git merge feature-login
6

7
# 3. 刪除已合併的分支（可選）
8
git branch -d feature-login

分支命名建議#

Fork & Pull Request 流程#

這是開源專案最常見的協作方式：

1. Fork（複製）別人的專案到你的帳號
2. Clone 到本地開發
3. 建立新分支，開始修改
4. Push 到你的 Fork
5. 發送 Pull Request 請求合併
6. 原作者審核後合併

團隊協作流程#

如果你是團隊成員，不需要 Fork：

1
# 1. Clone 專案
2
git clone https://github.com/team/project.git
3

4
# 2. 建立你的功能分支
5
git checkout -b feature-你的功能
6

7
# 3. 開發完成後推送
8
git push origin feature-你的功能
9

10
# 4. 在 GitHub 上發送 Pull Request

同步遠端更新#

團隊協作時，記得經常拉取最新版本：

1
# 拉取並合併遠端更新
2
git pull origin main
3

4
# 或者分兩步（更安全）
5
git fetch origin
6
git merge origin/main

🎭 現場一：「我只想提交一個檔案，不要全部上傳」#

情境：你改了 index.html（新功能完成了），但也順手改了 App.css（只是暫時調一下顏色，很亂），這時候如果你 git add . 就會把亂七八糟的 code 也傳上去了。

解法：只 Add 你確定要的檔案

1
# ❌ 不要用這個 (這會全加)
2
# git add .
3

4
# ✅ 用這個 (指定檔案)
5
git add index.html
6
git commit -m "feat: 完成首頁排版"
7
git push origin main

💡 為什麼這麼做？ 這叫「原子化提交 (Atomic Commit)」。讓每個 commit 只做一件事，這樣如果 index.html 出問題要撤回，才不會連無辜的 App.css 一起被撤掉。

🎭 現場二：「Push 失敗！說遠端版本比我的新」#

情境：你開開心心寫完 code，輸入 git push，結果出現紅字： error: failed to push some refs to '...' hint: Updates were rejected because the remote contains work that you do not have locally

這代表：你的隊友（或是另一個電腦的你）在你寫 code 的這段時間，已經先 push 了新版本上去。

解法：先 Pull 再 Push

1. 先拉取 (Pull)：把遠端的新程式碼抓下來跟你的合併。

   1
   git pull origin main
   

2. 處理合併：
   • 如果沒有衝突，Git 會自動跳出一個編輯器（通常是 Vim 或 VS Code）要你輸入 commit 訊息。
   • Vim 苦手請注意：如果看到畫面凍結，試著輸入 :wq (存檔離開)。
   • 建議設定 VS Code：執行 git config --global core.editor "code --wait"，這樣以後編輯訊息會直接開 VS Code，關掉視窗就算存檔完成。
3. 再推送 (Push)：

   1
   git push origin main
   

🎭 現場三：「發生衝突 (Conflict) 了怎麼辦？」#

情境：承上，當你 git pull 的時候，Git 告訴你： CONFLICT (content): Merge conflict in index.html Automatic merge failed; fix conflicts and then commit the result.

這代表：你跟隊友剛好改了 同一個檔案的同一行，Git 不知道要聽誰的。

解法：使用 VS Code 手動修復

1. 打開衝突的檔案 (例如 index.html)，你會看到 VS Code 貼心地把衝突標出來：

   • 綠色 Current Change：你原本寫的
   • 藍色 Incoming Change：隊友寫的

2. 決定留誰的：

   • 如果你的對，點擊上方小按鈕 Accept Current Change
   • 如果隊友對，點擊 Accept Incoming Change
   • 都要留，點擊 Accept Both Changes

3. 告訴 Git 你修好了：

   1
   git add index.html
   2
   git commit -m "fix: 解決標題合併衝突"
   3
   git push origin main
   

Q1：不小心 commit 錯了，怎麼撤回？#

1
# 撤回最後一次 commit，但保留修改
2
git reset --soft HEAD~1
3

4
# 撤回最後一次 commit，丟棄修改（危險！）
5
git reset --hard HEAD~1

Q2：改到一半想放棄，回到上次 commit 的狀態？#

1
# 放棄單一檔案的修改
2
git checkout -- 檔案名稱
3

4
# 放棄所有修改
5
git checkout -- .

Q3：Push 被拒絕，說遠端有更新？#

1
# 先拉取遠端更新
2
git pull origin main
3

4
# 如果有衝突，手動解決後
5
git add .
6
git commit -m "解決合併衝突"
7
git push origin main

Q4：合併衝突 (Merge Conflict) 怎麼辦？#

衝突時，Git 會在檔案中標記：

1
<<<<<<< HEAD
2
你的修改
3
=======
4
別人的修改
5
>>>>>>> branch-name

解決方式：

1. 手動編輯檔案，決定要保留哪個版本
2. 刪除 <<<<<<, ======, >>>>>> 標記
3. git add . → git commit

Q5：想忽略某些檔案（如 node_modules）？#

建立 .gitignore 檔案：

1
# 依賴目錄
2
node_modules/
3
vendor/
4

5
# 編譯產物
6
dist/
7
build/
8

9
# 環境變數
10
.env
11
.env.local
12

13
# IDE 設定
14
.vscode/
15
.idea/
16

17
# 系統檔案
18
.DS_Store
19
Thumbs.db

常用前綴#

範例#

1
# ✅ 好的 commit 訊息
2
git commit -m "feat: 新增使用者頭像上傳功能"
3
git commit -m "fix: 修正 iOS Safari 無法播放影片問題"
4

5
# ❌ 不好的 commit 訊息
6
git commit -m "更新"
7
git commit -m "修改程式碼"
8
git commit -m "asdfasdf"

Stash：暫存未完成的修改#

工作到一半要切換分支？用 stash 暫存：

1
# 暫存目前修改
2
git stash
3

4
# 切換分支處理其他事情
5
git checkout main
6
# ... 處理完畢 ...
7
git checkout feature-login
8

9
# 取回暫存的修改
10
git stash pop

Rebase：整理 commit 歷史#

1
# 互動式 rebase，整理最近 3 個 commit
2
git rebase -i HEAD~3

Cherry-pick：摘取特定 commit#

1
# 把某個 commit 複製到目前分支
2
git cherry-pick a1b2c3d