Repository 程式碼倉庫

保存專案程式碼、版本紀錄與協作內容的地方。

先用一句話理解

保存專案程式碼、版本紀錄與協作內容的地方。

打個比方

像專案的資料夾加上完整修改歷史。

什麼時候會遇到

任何需要用 GitHub、交給客戶、多人協作或部署的專案。

再往深一點看

Repository（倉庫）是 Git 用來儲存整個專案的容器，裡面不只有現在的程式碼，還有從第一天到今天每一次 commit 的完整紀錄。你在本機電腦上有一份本地 repository，GitHub 上有一份遠端 repository，兩者可以用 push 和 pull 同步。倉庫也記錄了所有 branch 的狀態，讓多人在同一份 codebase 上分頭工作而不互相干擾。一個健康的 repository 不只是「有地方放程式碼」，更是整個專案歷史、決策與協作的唯一可信來源。

舉個例子

你在 GitHub 上建了一個叫 my-app 的 repository，把本機程式碼 push 上去後，Vercel 就能讀這個 repository、自動部署。之後有新成員加入，他只要把這個 repository clone 下來，就能得到完整的程式碼與所有歷史紀錄。

常見誤解

- 只把程式碼放本機，沒有推到遠端 repository，一旦硬碟壞掉或換電腦，所有紀錄就消失了。
- 一個倉庫放很多不相關的小專案，導致部署設定混亂，每個小專案反而應該有自己的 repository。
- 把包含 API 金鑰或密碼的 .env 檔案也加入 repository，推上 GitHub 後等同公開這些機密資料。