MODULE 6 · 版本控制 · 6-3

GitHub 實戰:建立你的第一個雲端倉庫(重點提示:為什麼一定要設為 Private Repository?)

上一課的 push,把倉庫同步到雲端。雲端那個家,就是 GitHub。 這一課帶你開一個,並避開新手最常踩、後果最慘的兩個雷。

§1 · 這是什麼

GitHub:放程式碼的雲端硬碟

你已經會用 Google Drive 存檔案。GitHub 就是程式碼版的它。

平台
GitHub
專門放 Git 倉庫的雲端硬碟, 同時是全世界工程師協作的平台。類比「程式碼版的 Google Drive」。
名詞
遠端(remote)
你本機倉庫在雲端的分身。 push 上去、需要時再拉下來,本機壞了它還在。
§2 · 為什麼

為什麼要把程式碼放上雲端?

三個理由,後面幾課都會用到。

🛟
備份
電腦壞了、檔案誤刪,雲端還有一份完整的。
🤝
協作
之後跟別人一起做、或換電腦,都靠它同步。
🚀
部署前置
之後部署那幾課會用 GitHub 一鍵把網站上線。
看看「協作」長怎樣:你加了購物車,怎麼讓同事也拿到?
🧑‍💻
登入 + 購物車
🐙
GitHub
登入
👩‍💻
同事
登入
§3 · 動手做

建立你的第一個倉庫(repository)

一個專案一個倉庫。填個名字、選 Private,按下去。

誰看得到?
一個倉庫的正式名稱是 repository,大家都簡稱 repo
§4 · 接起來

把你電腦上的倉庫,接到 GitHub

本機有一份、雲端有一份,push 一下就同步。

💻
本機倉庫
你的電腦
🐙
GitHub 遠端
雲端的家
這個「雲端的遠端」習慣上叫 origin。你不用記指令,知道「本機一份、雲端一份、push 同步」就夠了。
§5 · 最重要的雷

為什麼一定要設成 Private?

把開關切到 Public,再點點看那個 .env 檔。

這個倉庫的權限:
🐙你 / my-ai-shop🔒 Private
🔒 Private:只有你(跟你邀請的人)看得到。安全。

程式碼裡常常藏著金鑰、密碼。一旦倉庫是 Public,這些祕密就攤在全世界面前。 所以:新手的第一個 repo,永遠先設 Private

§6 · 別把祕密推上去

哪些檔案,不該上傳到 GitHub?

幫每個檔案決定:上傳,還是放進「忽略清單」。

📄index.html
📄app.js
🔑.env
🔑node_modules/
提示:有金鑰的、還有那個幾萬檔的肥資料夾,應該設成「忽略」。
§7 · 小補充

順手寫個 README

一個好倉庫,門口會放一張說明。把這張陽春門牌補完整吧。

🐙你 / my-ai-shop🔒 Private
📖 README.md
# 我的 AI 商店
一個用 AI 打造的線上商店,含購物車與登入。

README.md 就是這個專案的門面。之後跟別人協作、或 AI 接手,都會先看它。

🔑VIBE CODER 秘訣
👀觀察
README 不用一個字一個字自己刻——AI 最會根據你的專案內容,生這種說明文件。
💬怎麼跟 AI 講
「幫我根據這個專案,寫一份 README,包含它在做什麼、怎麼啟動、用到哪些技術。」
§8 · 站在別人的肩膀上

Clone:把別人的好專案,整包拉下來

不用每次都從零開始。找個現成範本,clone 下來當起點。

🐙
GitHub 上的範本
別人寫好的好專案
💻
你的電腦
空的
把雲端的整個倉庫複製一份到你電腦,這個動作叫 clone。 對 Vibe Coder 超實用:看到喜歡的開源範本,clone 下來改成自己的,省下大把時間。
§9 · 收進口袋

秘訣 + 快速檢查

答錯不會鎖死,可以一直重選。

🔑VIBE CODER 秘訣
👀觀察
祕密(金鑰、密碼)永遠別進版控;新 repo 一律先 Private。這兩件事 AI 不一定會主動幫你顧。
💬怎麼跟 AI 講
建專案時就交代:「幫我把這個專案推上一個 private 的 GitHub repo,並把 .env 加進 .gitignore。」
答對 0 / 2
Q1

你要建立第一個放程式碼的 GitHub 倉庫,該設 Public 還是 Private?

Q2

下面哪個檔案,最該放進「忽略清單」(.gitignore)、絕對不要上傳?

🎒這一課帶走的
GitHubrepository / repoPrivate.gitignore

GitHub 是你程式碼的雲端家;一個專案一個 repo。 兩個保命原則:新 repo 先設 Private、 祕密檔案(.envnode_modules)放進忽略清單別上傳。

下一課 程式碼已經用 Git 存好、也安全上雲了。但 App 真正要存的,是「用戶的資料」(帳號、訂單、留言這些)。6-4 資料庫:先搞懂 App 為什麼非要一個資料庫不可,它到底在幫你顧哪些事。