# GitHub 基本操作 # Day 1 --- **GitHub 基本操作 — Day 1** 從零開始，打造你的第一個專案 **講師：** 潘昱昕 --- ## 課程目標 1. 了解 Git 與 GitHub 的差別 2. 在 GitHub 建立 Repository（倉庫） 3. 在網頁上上傳、編輯檔案並 Commit 4. 完成一個簡單的實作練習 --- ## 課程流程（時間分配） * 課程介紹 & 目標說明 * Git 與 GitHub 基礎概念 * GitHub 基本操作示範（建立 Repo、上傳、編輯） * 回顧與問答 --- ## 第一單元：基礎概念 ---- ### 什麼是 Git？ * 分散式版本控制系統（Version Control System） * 幫你記錄檔案每次修改的歷史（commit） * 可以查看、回復舊版本、比較差異 ---- ### 什麼是 GitHub？ * 基於 Git 的雲端平台 * 用於儲存專案、協作、發佈程式碼 * 提供 PR（Pull Request）、Issue、Actions 等功能（進階） --- ## 第二單元：建立 GitHub 帳號 1. 開啟 [https://github.com](https://github.com) 2. 點「Sign up」，輸入 Email、username、password 3. 驗證 Email 4. 建議設定：公開名稱（Display name）與 Email（後續會在 Commit 顯示） --- ## 第三單元：建立第一個 Repository 1. 登入後點右上 + → **New repository** 2. Repository name：`my-first-repo`（或 `hello-github`） 3. Description（選填） 4. Public（公開）或 Private（私人）— 初學者可選 Public 5. **Add a README**：勾選（會自動建立 README.md） 6. 點 Create repository --- ## 第四單元：在網頁上上傳檔案 1. 進入剛建立的 Repo 2. 點「Add file」→「Upload files」 3. 拖拉 `hello.txt` 或 `example.py` 上傳 4. 下方填寫 **Commit changes** 的訊息（例如 `Add hello.txt`） 5. 按下 Commit changes ---- **示範 Commit 訊息寫法**： * 簡潔描述：`Add` / `Fix` / `Update` + 檔名或功能 * 範例：`Add hello.txt`、`Update README.md`、`Fix typo in README` --- ## 第五單元：直接在 GitHub 上編輯檔案 1. 點選檔案（例如 README.md） 2. 右上鉛筆圖示（Edit this file） 3. 修改內容（例如加入一句自我介紹） 4. 下方填寫 Commit 訊息 → 選擇 Commit to main --- ## 實作練習 1. 建立一個 Repository，命名 `hello-github`。 2. 上傳一個檔案 `hello.txt`（內容：一行自我介紹） 3. 在 GitHub 網頁上編輯 `hello.txt` 並 Commit --- ## 常見問題與排錯（Instructor Tips） 1. **找不到 Create repository 按鈕**：確認是否已登入 2. **上傳檔案失敗**：檔案大小或網路問題，嘗試重新上傳 3. **Commit 沒顯示**：檢查是否在正確的 branch（main） 4. **想要刪除 Repo**：Repo → Settings → Danger Zone → Delete this repository --- ## 線上資源（可選） * 官方說明（教學）：[https://docs.github.com](https://docs.github.com) * 推薦入門影片：YouTube（搜尋 GitHub Tutorial） --- ## 課程回顧 * 今天重點回顧：Git vs GitHub、建立 Repo、上傳與編輯檔案 * 題外預告：下一堂會教 **在本機安裝 Git 與基本命令（clone、commit、push）** ---