---
title: "02 - 安裝與初始設定"
type: note
specialty: Programming
tags: [git-github, 02-安裝與初始設定]
---

# 02 - 安裝與初始設定

← [[01-什麼是Git與版本控制]] | 下一篇 → [[03-基本工作流程]]

---

## 📥 安裝 Git

### macOS

**方法一：Homebrew（推薦）**

```bash
# 先安裝 Homebrew（如果還沒有的話）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安裝 Git
brew install git
```

**方法二：Xcode Command Line Tools**

```bash
xcode-select --install
```

### Windows

到 [git-scm.com](https://git-scm.com/download/win) 下載安裝檔，一路點 Next 即可。

安裝完成後，從開始選單打開 **Git Bash** 來使用。

### Linux（Ubuntu/Debian）

```bash
sudo apt update
sudo apt install git
```

---

## ✅ 確認安裝成功

打開終端機（Terminal），輸入：

```bash
git --version
```

看到版本號就代表安裝成功，例如：

```
git version 2.43.0
```

---

## ⚙️ 初始設定（只需要做一次）

安裝完 Git 之後，要先告訴 Git 你是誰。這些資訊會出現在每一次 commit 的紀錄裡。

### 設定姓名與 Email

```bash
# 設定你的名字（可以用中文或英文）
git config --global user.name "你的名字"

# 設定你的 Email（建議和 GitHub 帳號一致）
git config --global user.email "your@email.com"
```

> `--global` 表示這個設定套用到你電腦上所有的 Git 專案

### 設定預設分支名稱

```bash
# 將預設主分支名稱設為 main（現代標準）
git config --global init.defaultBranch main
```

### 設定預設編輯器（選用）

```bash
# 使用 VS Code 作為編輯器
git config --global core.editor "code --wait"

# 使用 nano（終端機輕量編輯器）
git config --global core.editor nano
```

---

## 🔍 確認設定內容

```bash
# 查看所有 global 設定
git config --global --list
```

輸出範例：

```
user.name=DirtyWolf
user.email=dirtywolf1213@gmail.com
init.defaultbranch=main
```

---

## 🔑 設定 SSH Key（用於連接 GitHub，推薦）

使用 SSH 的好處：push/pull 時不需要每次輸入密碼。

### Step 1：產生 SSH Key

```bash
# 將 email 換成你的 GitHub 帳號 email
ssh-keygen -t ed25519 -C "your@email.com"
```

一路按 Enter 使用預設設定即可。

### Step 2：複製公鑰

```bash
# macOS
cat ~/.ssh/id_ed25519.pub | pbcopy

# Linux
cat ~/.ssh/id_ed25519.pub
# 手動複製輸出的內容
```

### Step 3：貼到 GitHub

1. 打開 GitHub → 右上角頭像 → **Settings**
2. 左側選單 → **SSH and GPG keys**
3. 點 **New SSH key**
4. 貼上剛才複製的公鑰，按 **Add SSH key**

### Step 4：測試連線

```bash
ssh -T git@github.com
```

成功的話會看到：

```
Hi dirtywolf1213! You've successfully authenticated, but GitHub does not provide shell access.
```

---

## 📌 小結

| 指令 | 用途 |
|------|------|
| `git config --global user.name "名字"` | 設定姓名 |
| `git config --global user.email "email"` | 設定 Email |
| `git config --global --list` | 查看所有設定 |
| `ssh-keygen -t ed25519 -C "email"` | 產生 SSH key |

---

← [[01-什麼是Git與版本控制]] | 下一篇 → [[03-基本工作流程]]