版本控制不可怕：AI 改壞了，一個指令救回來

想像你在寫一份重要文件，每隔一段時間你會另存新檔。Git 做的是同一件事，只是更聰明：它只記錄每次的差異，不是整份複製，而且每個版本都有說明、有時間戳，還可以命名。對 Vibe Coder 來說，Git 最重要的一個功能是：隨時能回到任何一個「程式還在運作」的時間點。AI 改壞了？一個指令回去。新功能搞砸了？一個指令回去。這是 Vibe Coding 最重要的安全網。

為什麼 Vibe Coder 必須學 Git

核心概念：repo、commit、branch

基本工作流

# 初始化：在專案資料夾建立 Git repo
git init

# 查看目前狀態：哪些檔案有變動
git status

# 把所有變動加入暫存區
git add .

# 存檔（commit），說明這次改了什麼
git commit -m "新增使用者登入功能"

# 查看版本歷史
git log --oneline

# 回到上一個 commit（AI 改壞時用這個）
git checkout HEAD~1

.gitignore 與安全守則

.gitignore 是一個文字檔，列出不要讓 Git 追蹤的檔案和資料夾。最重要的用途：防止 API Key 和敏感資訊被上傳到 GitHub。

# .gitignore（Vibe Coder 基本版）

# 環境變數（絕對不能上傳）
.env
.env.local
.env.production

# Python 虛擬環境
.venv/
__pycache__/
*.pyc

# Node.js 套件
node_modules/

# 系統檔案
.DS_Store
Thumbs.db

# IDE 設定（個人設定不需要讓別人看到）
.cursor/

AI 改壞了怎麼救

1. 確認最後一個正常的 commit：執行 git log --oneline，找到「功能還在運作」的那個 commit 的 hash（前七碼）。
2. 回到那個版本：執行 git checkout HASH值，程式碼會回到那個時間點的狀態。
3. 建立新 branch 繼續試：執行 git checkout -b fix/try-again，在新 branch 上重新嘗試，不影響主線。

GitHub 入門

Git 是本機的版本控制工具，GitHub 是把 Git repo 放到網路上的平台，兩個東西不一樣，但通常一起用。

1. 在 github.com 建立帳號，點「New Repository」，輸入名稱，選「Private」（先不要公開），點「Create」。
2. 複製 GitHub 給你的 HTTPS 連結，格式是 https://github.com/你的帳號/專案名稱.git。
3. 在本機專案資料夾執行指令，把本機 repo 連接到 GitHub。
4. 之後每次 commit 完，只需要執行 git push 就能同步到 GitHub。

git remote add origin https://github.com/你的帳號/專案名稱.git
git branch -M main
git push -u origin main