04 - GitHub 入門

← 03-基本工作流程 | 下一篇 → 05-Push與Pull

---

📝 建立 GitHub 帳號

1. 前往 github.com
2. 點右上角 Sign up
3. 填入 Email、密碼、使用者名稱
4. 驗證 Email

---

🆕 建立一個新的 Repository（repo）

Repository（倉庫） 是 GitHub 上存放你的專案的地方。

步驟

1. 登入後，點右上角的 + → New repository
2. 填入設定：

欄位	說明	建議
Repository name	repo 的名稱	用英文，不要有空格，可以用 - 連接
Description	描述（可選）	簡短說明這個 repo 是什麼
Public / Private	公開或私人	個人筆記建議選 Private
Initialize with README	自動建立 README	如果本地還沒有 repo，可以勾
.gitignore template	忽略清單模板	依你的語言選

3. 按 Create repository

---

🔗 連接本地 repo 到 GitHub

假設你已經在本地用 git init 建立了 repo，現在要連接到 GitHub：

使用 HTTPS（較簡單，但每次需要輸入密碼或 token）

# 加入遠端 repo 的網址
git remote add origin https://github.com/username/repo-name.git
 
# 確認設定成功
git remote -v

使用 SSH（推薦，設定一次後不需要再輸入密碼）

# 加入遠端 repo 的 SSH 網址
git remote add origin git@github.com:username/repo-name.git
 
# 確認設定成功
git remote -v

輸出範例：

origin  git@github.com:dirtywolf1213/Obsidian-med-note.git (fetch)
origin  git@github.com:dirtywolf1213/Obsidian-med-note.git (push)

origin 是遠端 repo 的別名（nickname），可以自己取名，但習慣上都叫 origin

---

📂 複製別人的 repo（git clone）

如果你想把 GitHub 上的 repo 下載到本地：

# 使用 HTTPS 複製
git clone https://github.com/username/repo-name.git
 
# 使用 SSH 複製（需要先設定 SSH key）
git clone git@github.com:username/repo-name.git
 
# 複製到指定資料夾
git clone https://github.com/username/repo-name.git my-folder

git clone 會自動：

• 下載完整的 repo（包含所有歷史）
• 設定好 remote（自動叫做 origin）

---

🔑 GitHub 身份驗證

方法一：Personal Access Token（HTTPS 用）

GitHub 在 2021 年後不再接受密碼，需要用 Token：

1. GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
2. 點 Generate new token
3. 選擇有效期限和權限（至少要勾 repo）
4. 生成後立刻複製！（只會顯示一次）
5. 往後 push 時，密碼欄位輸入這個 token

方法二：SSH Key（推薦）

見 02-安裝與初始設定 的 SSH Key 設定章節。

---

🌐 GitHub 介面重要功能

功能	說明
Code	瀏覽 repo 的檔案
Commits	查看所有 commit 歷史
Issues	追蹤問題、待辦事項
Pull Requests	多人協作的合併請求
Actions	自動化工作流程（CI/CD）
Settings	repo 設定（可設為 Private）

---

📌 小結

指令	用途
git remote add origin [URL]	連接遠端 repo
git remote -v	查看遠端設定
git clone [URL]	下載 GitHub 上的 repo
git remote remove origin	移除遠端連接

---

← 03-基本工作流程 | 下一篇 → 05-Push與Pull