詳細解釋如何使用 GitHub 存儲庫

 

📌 詳細解釋如何使用 GitHub 存儲庫

你想要 把 VS Code 連結到 GitHub，讓你的程式碼可以儲存到雲端，這樣就不怕遺失，也可以在不同電腦上存取，甚至與他人協作。

這裡會一步步帶你完成 GitHub 註冊、建立存儲庫（repository）、設定 Git、連結 VS Code，並將程式碼推送到 GitHub。

---

1️⃣ 註冊 GitHub 帳號

如果你還沒有 GitHub 帳號，請按照以下步驟註冊：

📌 註冊步驟

1. 開啟 GitHub 官方網站 👉 https://github.com/
2. 點擊 「Sign up（註冊）」
3. 填寫帳號資訊：
   • Username（使用者名稱） → 這是你的 GitHub ID，例如 my-python-projects
   • Email（電子郵件） → 填入你的 Email
   • Password（密碼） → 設定一組安全的密碼
4. 點擊「Create account（建立帳號）」
5. 通過機器人驗證（CAPTCHA）
6. 驗證你的 Email：
   • GitHub 會寄一封 驗證信 到你的 Email
   • 打開 Email，點擊信件內的驗證連結

🎉 你現在已經有 GitHub 帳號了！

---

2️⃣ 建立 GitHub 存儲庫（Repository）

存儲庫（repository） 就像是 雲端資料夾，用來存放你的程式碼。

📌 建立存儲庫步驟

1. 登入 GitHub 👉 https://github.com/
2. 點擊右上角的 「+」，選擇 「New repository（新建存儲庫）」
3. 填寫存儲庫資訊：
   • Repository name（存儲庫名稱） → 例如 my-first-repo
   • Description（描述） → 可選，寫個簡單介紹
   • 選擇可見性：
     • 🔓 Public（公開） → 任何人都可以看到（開源專案適合）
     • 🔒 Private（私有） → 只有你自己能看到（推薦）
   • ✅ 勾選「Add a README file」（讓存儲庫有 README 介紹）
4. 點擊「Create repository（建立存儲庫）」 🎉

📌 這時候 GitHub 會顯示你的存儲庫網址（例如）：

https://github.com/你的GitHub帳號/my-first-repo.git

⚠️ 請複製這個網址，稍後會用到！

---

3️⃣ 安裝 Git（如果還沒安裝）

Git 是版本控制工具，它讓你的 VS Code 可以與 GitHub 連結。

📌 安裝 Git（Windows）

1. 下載 Git 👉 https://git-scm.com/downloads
2. 執行安裝程式，安裝時請務必勾選「Add Git to PATH」
3. 安裝完成後，檢查 Git 是否正常運行：
   • 開啟 Windows 命令提示字元（CMD）或 PowerShell
   • 輸入：

     git --version
     

   • 若顯示 Git 版本號（如 git version 2.x.x），代表安裝成功！

---

4️⃣ 設定 Git

你需要設定 Git，讓 GitHub 知道你的身份。

📌 設定 Git 用戶名與 Email

1. 開啟 VS Code
2. 打開終端機（Terminal）：
   • Windows 按 `Ctrl + Shift + ``（或使用「檢視 → 終端機」）
3. 輸入以下指令，設定你的 GitHub 帳號資訊：

   git config --global user.name "你的GitHub帳號"
   git config --global user.email "你的GitHub Email"
   

4. 確認是否設定成功：

   git config --list
   

   • 若看到 user.name=你的GitHub帳號，代表設定成功！

---

5️⃣ 連結 VS Code 與 GitHub

1. 開啟 VS Code，進入你的專案資料夾
   • 若還沒建立專案，可先創建一個新資料夾，如：

     C:\Users\你的名稱\Documents\my-python-project
     

   • 然後在 VS Code 中 開啟此資料夾
2. 開啟終端機（Terminal），輸入以下指令：

   git init
   

   • 這會在你的資料夾內建立一個 .git 目錄，讓它變成 Git 專案
3. 將本機專案與 GitHub 存儲庫綁定：

   git remote add origin https://github.com/你的GitHub帳號/my-first-repo.git
   

   • 請把 https://github.com/... 換成你的存儲庫網址！
   • origin 代表遠端存儲庫名稱，預設為 GitHub

---

6️⃣ 提交（Commit）與推送（Push）程式碼到 GitHub

1. 檢查目前的 Git 狀態：

   git status
   

   • 若顯示 Untracked files，代表有未追蹤的檔案
2. 將所有檔案加入 Git 追蹤：

   git add .
   

3. 提交（Commit）變更：

   git commit -m "第一次提交程式碼"
   

4. 推送（Push）到 GitHub：

   git branch -M main
   git push -u origin main
   

   • -u origin main 代表將主分支（main）推送到遠端 GitHub
5. 開啟 GitHub 網頁，查看你的存儲庫
   • 你應該會看到剛剛提交的檔案！

🎉 恭喜！你成功將 VS Code 的程式碼上傳到 GitHub！

---

📌 常見問題

❓ 如何從 GitHub 下載（克隆）專案？

如果你想在另一台電腦下載你的 GitHub 專案：

1. 開啟 VS Code
2. 在終端機輸入：

   git clone https://github.com/你的GitHub帳號/my-first-repo.git
   

3. 專案會被下載到本機！

---

📌 總結

✅ GitHub 存儲庫是雲端程式碼倉庫
✅ Git 是版本控制工具，能讓 VS Code 與 GitHub 連結
✅ 使用 git init 讓 VS Code 支援 Git
✅ 使用 git add .、git commit -m "訊息"、git push 上傳程式碼

現在，你的程式碼已經安全地存放在 GitHub，不會遺失！🚀
如果有任何問題，請隨時問我！😊