1. Git 簡介

Git 是一款分布式版本控制系統，用來跟蹤文件變化、協作開發、管理項目版本。
它是開源的，由 Linus Torvalds 在 2005 年開發，廣泛用于開源與企業項目中。

---

2. 安裝 Git

Windows

1. 前往 Git 官網 下載并安裝。

2. 安裝時建議勾選 Git Bash，方便在命令行使用。

Linux

sudo apt install git    # Ubuntu/Debian
sudo yum install git    # CentOS/RHEL

macOS

brew install git

---

3. 配置 Git

首次使用需要設置用戶名和郵箱，這些會記錄在提交歷史中。

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

查看配置：

git config --list

---

4. 創建與克隆倉庫

新建本地倉庫

mkdir myproject
cd myproject
git init

克隆遠程倉庫

git clone https://github.com/用戶名/倉庫名.git

---

5. 常用工作流

1. 查看文件狀態

git status

1. 將文件添加到暫存區

git add 文件名
git add .  # 添加所有改動

1. 提交更改

git commit -m "提交說明"

1. 查看提交歷史

git log
git log --oneline --graph --decorate --all  # 簡潔圖形化查看

---

6. 連接遠程倉庫

git remote add origin 倉庫地址
git remote -v   # 查看遠程地址

---

7. 推送與拉取

推送本地分支到遠程

git push origin 分支名
# 第一次推送建議：
git push -u origin main

拉取遠程分支更新

git pull origin 分支名

---

8. 分支管理

git branch                # 查看分支
git branch 新分支         # 創建分支
git checkout 分支名        # 切換分支
git checkout -b 新分支     # 創建并切換
git merge 分支名           # 合并分支
git branch -d 分支名       # 刪除分支

---

9. 回退與撤銷

回退到上一個提交

git reset --hard HEAD^

撤銷文件修改

git checkout -- 文件名

---

10. .gitignore 忽略文件

在項目根目錄創建 .gitignore 文件，寫入要忽略的內容：

node_modules/
*.log
*.tmp
.DS_Store

---

11. 常用技巧

• 查看某個文件的歷史：

git log 文件名

• 查看兩個版本的差異：

git diff 版本1 版本2

• 暫存當前修改：

git stash
git stash pop

---

12. 常見問題

1. 推送報錯 non-fast-forward
原因：遠程有新的提交，本地落后。
解決：

git pull --rebase origin 分支名
git push origin 分支名

2. 誤刪分支
如果分支還在 reflog 中，可以恢復：

git reflog
git checkout 版本號

---

📌 總結

• Git 三個關鍵區域：工作區 → 暫存區 → 倉庫。

• 常用四步：

  git add .
  git commit -m "說明"
  git push
  git pull
  

• 養成寫清晰提交信息的習慣。