W1 — Git 操作練習

先完成「基本操作」熟悉 Git 核心指令，再進入「功能開發」練習真實的 feature branch 與 Pull Request 工作流。

Git 版本控制如同時光機：每次 commit 都是一個存檔點，可以隨時回到任何時間點

建立練習專案

建立一個新資料夾，用 git init 初始化成 Git 儲存庫，然後建立一個簡單的檔案。

$mkdir my-first-repo
$cd my-first-repo
$git init

# 建立一個檔案
$echo "# My First Repo" > README.md

git add 與 git commit

將檔案加入暫存區（staging），然後提交一次 commit。每次 commit 都是一個存檔點，可以隨時回到這個狀態。

# 查看目前狀態
$git status

# 將檔案加入暫存區
$git add README.md

# 提交 commit
$git commit -m "Initial commit: add README"

練習：再新增一個檔案，重複 add → commit 的流程

git branch 與 git checkout

Branch 是 Git 的分支功能，讓你在不影響主線的情況下開發。建立一個新分支，切換過去，觀察差異。

# 建立並切換到新分支
$git checkout -b test-branch

# 在新分支上修改檔案
$echo "Hello from test-branch" >> README.md
$git add README.md
$git commit -m "Edit README on test-branch"

# 切回主分支，觀察 README 內容的差異
$git checkout main
$cat README.md

# 查看所有分支
$git branch

推上 GitHub

在 GitHub 上建立一個新的 repository（不要勾選 Initialize），然後將本機的專案推上去。

# 將 GitHub repo 設為遠端（替換成你的 repo 網址）
$git remote add origin git@github.com:你的帳號/my-first-repo.git

# 推送主分支
$git push -u origin main

到 GitHub 上確認你的 repo 已經有 README.md

情境：你要為專案加一個新功能。正確的做法是從 main 開一個 feature branch，在上面開發完成後推到 GitHub，再透過 Pull Request 請求合併回 main。這是業界標準的協作流程。

從 main 開一個 feature branch

確保你在 main 分支上，然後建立一個新的功能分支。分支名稱用 feature/ 前綴，清楚表達這是一個功能開發。

# 確保在 main 且是最新狀態
$git checkout main
$git pull origin main

# 建立並切換到 feature branch
$git checkout -b feature/add-about-page

在 feature branch 上開發

在這個分支上完成你的功能。可以多次 commit，每個 commit 對應一個有意義的修改。

# 建立新檔案
$echo "# About" > ABOUT.md
$echo "This project is a Git practice exercise." >> ABOUT.md

# 第一次 commit：新增檔案
$git add ABOUT.md
$git commit -m "Add ABOUT page"

# 繼續修改
$echo "Created for AI Agent course, Week 1." >> ABOUT.md

# 第二次 commit：補充內容
$git add ABOUT.md
$git commit -m "Add course info to ABOUT page"

推送 feature branch 到 GitHub

把你的功能分支推到遠端，這時候 main 不會受到任何影響。

$git push -u origin feature/add-about-page

到 GitHub 上確認多了一個 feature/add-about-page 分支

在 GitHub 上發 Pull Request

Pull Request 是請求把你的 feature branch 合併回 main 的正式流程。在 PR 頁面可以看到所有的改動差異。

到 GitHub 上你的 repo 頁面，會看到黃色提示列，點 Compare & pull request
確認方向：base 是 main ← compare 是 feature/add-about-page
填寫 PR 標題，例如 Add ABOUT page
在描述中寫清楚這個 PR 做了什麼、為什麼要做
點 Create pull request

Review 與 Merge

在 PR 頁面檢視 Files changed 分頁，確認改動內容正確，然後合併。

點 Files changed 分頁，逐一檢視修改的差異（diff）
確認沒問題，回到 Conversation 分頁
點 Merge pull request → Confirm merge

同步本機的 main

PR 合併後，遠端的 main 已經更新了。把變更拉回本機，保持同步。

# 切回 main
$git checkout main

# 拉取合併後的最新內容
$git pull origin main

# 確認 ABOUT.md 已經在 main 上了
$cat ABOUT.md

完成！你已經走過一次完整的 feature branch → PR → merge 工作流