Repo 是什麼？GitHub Repository 新手入門：用法與避坑

Repo 是 repository 的縮寫，在程式開發裡通常翻成「儲存庫」或「程式碼儲存庫」。

如果你剛開始學寫程式，很快就會遇到 GitHub repo、clone repo、fork repo、push 到 repo、開 pull request 這些詞。

一開始看起來會有點抽象，但 repo 其實是現代程式開發非常核心的概念：它不是單純放檔案的資料夾，而是一個可以記錄版本、管理程式碼、協作開發、追蹤問題、發布版本的專案中心。

本文會用新手能理解的方式，帶你認識 repo 是什麼、Git 和 GitHub 差在哪、常見操作流程、常見誤解，以及建立第一個 repo 前要注意哪些事。

---

Repo 是什麼？

Repo 是 repository 的簡稱，意思是「儲存庫」。

在程式開發中，repo 通常指的是一個專案的程式碼儲存空間，裡面會放程式碼、圖片、設定檔、文件、README、版本紀錄，以及團隊協作時需要用到的各種資訊。

GitHub 官方文件也提到，repository 會包含專案的 code、files，以及每個檔案的 revision history，也就是版本歷史。

換句話說，repo 不只是「一個雲端資料夾」，而是一個有歷史紀錄、有分支、有協作流程的專案基地。

如果用生活化的比喻來說，repo 有點像是一間有完整出入紀錄的工作室。你不只知道現在工作室裡有哪些東西，也能知道誰在什麼時間改了什麼、為什麼改、改完後能不能合併到正式版本。

參考資料：GitHub 官方文件：About repositories

---

Repo、Git、GitHub 差在哪？

新手最常混淆的地方，就是把 repo、Git、GitHub 當成同一件事。其實它們有關係，但不是同一個東西。

• Repo：一個專案的儲存庫，裡面保存程式碼、檔案與版本紀錄。
• Git：一套版本控制系統，用來記錄檔案變更、建立分支、回復版本、合併修改。
• GitHub：一個使用 Git 技術的雲端平台，讓你可以把 repo 放上網路，並和其他人協作。

你可以這樣理解：Git 是工具，GitHub 是平台，repo 是你管理的專案單位。

即使沒有 GitHub，你仍然可以在自己的電腦使用 Git 建立 repo；但如果你想把專案放到雲端、展示作品集、跟別人一起協作，GitHub、GitLab、Bitbucket、Azure Repos 這類平台就會很有用。

參考資料：Git 官方詞彙表

---

GitHub Repo 可以拿來做什麼？

對新手來說，GitHub repo 最常見的用途，就是保存自己的程式作品。

例如你做了一個個人網站、一個 Todo App、一個爬蟲工具、一個資料分析專案，都可以建立一個 repo，把程式碼和說明文件放進去。

如果這些專案是你用 AI 輔助寫出來的，也可以延伸閱讀〈Vibe Coding 是什麼？AI 寫程式新手入門〉，了解怎麼把 AI 寫出來的程式好好放進 repo 管理。

Repo 也很適合拿來做作品集。很多工程師在求職時，會把自己的 GitHub repo 放在履歷裡，讓面試官可以看到你做過什麼專案、如何寫 README、commit 紀錄是否清楚、程式碼是否有基本整理。

除了個人用途，repo 更常出現在團隊協作。例如一個網站專案可能有前端工程師、後端工程師、設計師、PM、測試人員，每個人都可能需要知道專案進度、查看程式碼、提出問題、修 bug、審查修改內容。

這些事情都可以透過 repo 搭配 GitHub、GitLab 這類平台完成。

---

新手一定要懂的 Repo 基本概念

1. Commit：把修改正式記錄下來

Commit 可以理解成一次正式的版本紀錄。你平常按「儲存」只是把檔案存下來，但 commit 是把一組修改正式記錄到 Git 歷史裡，並且通常會加上一段說明。

例如：

• add login page
• fix navbar layout
• update README installation guide

好的 commit message 可以讓未來的你知道當時為什麼這樣改，也能讓團隊成員更快理解專案變化。

2. Branch：開一條安全的修改路線

Branch 是分支，也可以理解成一條平行的開發路線。通常正式版本會放在 main branch，如果你要新增功能或修 bug，不建議直接在 main 上修改，而是先開一個新的 branch。

例如：

• feature/login-page
• fix/payment-error
• docs/update-readme

這樣做的好處是，就算你在新分支上改壞了，也不會直接影響正式版本。等修改完成、測試沒問題，再把 branch 合併回 main。

3. Clone：把 repo 複製到自己的電腦

Clone 是把遠端 repo 下載到你的本機電腦。例如你看到 GitHub 上有一個專案，想在自己的電腦上查看或修改，就可以 clone 下來。

常見指令如下：

git clone https://github.com/example/project.git

Clone 不是單純下載檔案，它會連同 Git 版本歷史一起抓下來，所以你可以在本機查看過去的 commit 紀錄。

4. Push：把本機修改推到遠端 repo

Push 是把你本機完成的 commit 推送到 GitHub 或其他遠端平台。簡單說，就是把你電腦裡的修改同步到雲端 repo。

常見指令如下：

git push origin main

如果是團隊專案，push 前通常要先確認自己有沒有拉到最新版本，否則可能遇到衝突。

5. Pull：把遠端 repo 的更新拉回本機

Pull 是把遠端 repo 的更新抓回自己的電腦，並合併到目前的本機版本。如果同事已經修改並推送了新的程式碼，你就需要 pull 回來，讓自己的本機專案保持最新。

常見指令如下：

git pull origin main

新手要注意，pull 和 pull request 不是同一件事。pull 是 Git 指令，pull request 是 GitHub、GitLab 這類平台上的協作流程。

6. Pull Request：請別人檢查你的修改

Pull Request 通常簡稱 PR，是現代團隊開發中非常重要的流程。當你在自己的 branch 完成修改後，不會直接把它合併進 main，而是開一個 pull request，請團隊成員檢查你的修改。

PR 通常可以看到：

• 你改了哪些檔案
• 新增或刪除了哪些程式碼
• 為什麼要做這次修改
• 測試是否通過
• 其他人留下的 review 意見

如果你以後進入公司或參與開源專案，PR 幾乎一定會遇到。

參考資料：GitHub 官方文件：About pull requests

7. Fork：複製一份別人的 repo 到自己帳號

Fork 很常出現在開源專案。如果你沒有權限直接修改某個 repo，但你想替它修 bug 或補文件，就可以先 fork 一份到自己的 GitHub 帳號。

接著你在自己的 fork 版本裡修改，完成後再發 pull request 給原專案。

新手常把 fork 和 clone 搞混，簡單區分如下：

• Clone：把 repo 從雲端下載到你的電腦。
• Fork：把別人的 repo 複製一份到你的 GitHub 帳號。

參考資料：GitHub 官方文件：Fork a repo

---

---

建立第一個 GitHub Repo 的基本流程

如果你是完全新手，可以照著下面的順序理解。

步驟一：註冊 GitHub 帳號

先到 GitHub 官網註冊帳號。GitHub 網址：https://github.com/

如果你只是要練習和放作品集，GitHub 免費帳號通常已經夠用。但不同平台的方案、額度、功能會隨時間改變，如果你要用在公司或正式產品，建議重新確認官方價格頁與功能限制。

步驟二：建立新的 repository

登入 GitHub 後，可以點選 New repository 建立新的 repo。建立時通常會看到幾個選項：

• Repository name：repo 名稱，例如 my-first-website。
• Description：簡短描述這個專案是什麼。
• Public：公開，任何人都能看到。
• Private：私人，只有被授權的人能看到。
• README：專案說明文件。
• .gitignore：設定哪些檔案不要被 Git 追蹤。
• License：授權條款，決定別人能不能使用你的程式碼。

如果是新手練習作品集，可以先建立 public repo。但如果 repo 裡面有公司資料、客戶資料、API key、帳號密碼、商業機密，就不要公開。

步驟三：在電腦安裝 Git

如果你要在本機操作 repo，需要安裝 Git。Git 官方網站：https://git-scm.com/

安裝完成後，可以用以下指令確認：

git --version

如果有出現 Git 版本號，代表安裝成功。

步驟四：把 repo clone 到本機

建立 repo 後，你可以把它 clone 到本機電腦。

git clone https://github.com/your-name/your-repo.git

這樣你的電腦就會多一個專案資料夾，裡面會連同 Git 設定一起建立好。

步驟五：修改檔案並 commit

接著你可以開始修改專案檔案。修改完後，可以依序執行：

git status
git add .
git commit -m "update project files"

其中 git status 可以查看目前哪些檔案被修改，git add 是把修改加入準備提交的區域，git commit 是正式建立版本紀錄。

步驟六：push 到 GitHub

完成 commit 後，再把修改推回 GitHub。

git push origin main

接著回到 GitHub repo 頁面，如果你看到剛剛的檔案變更和 commit message，就代表成功了。

---

README 是什麼？為什麼很重要？

README 通常是 repo 裡最重要的說明文件，檔名常見為 README.md。當別人打開你的 GitHub repo，第一眼通常就是看到 README。

一個好的 README 至少應該包含：

• 這個專案是什麼
• 它可以解決什麼問題
• 如何安裝
• 如何執行
• 需要哪些環境變數
• 主要功能有哪些
• 使用範例
• 授權方式

如果你想把 GitHub 當作品集經營，README 真的很重要。很多新手只把程式碼丟上去，但沒有說明專案目的、使用方法、畫面截圖，結果別人根本不知道這個 repo 能做什麼。

參考資料：GitHub 官方文件：About READMEs

---

.gitignore 是什麼？

.gitignore 是一個很重要但很容易被新手忽略的檔案。它的功能是告訴 Git：哪些檔案或資料夾不要被追蹤、不要被 commit 進 repo。

常見需要忽略的內容包括：

• node_modules
• .env
• 系統暫存檔
• 編譯後產生的檔案
• 本機開發工具設定
• log 檔案

特別要注意的是 .env。很多專案會把 API key、資料庫密碼、第三方服務 token 放在 .env 裡，這種檔案通常不應該被 commit 到 repo。

如果你不小心把 API key push 到 public repo，不要只把檔案刪掉就以為沒事。因為 Git 歷史裡可能還留著那組 key，正確做法通常是立刻到該服務後台撤銷或重新產生金鑰。

參考資料：GitHub 官方文件：Ignoring files

---

Public Repo 不等於 Open Source

這是新手非常容易誤解的地方。很多人以為，只要 GitHub repo 是 public，別人就可以自由拿去使用、修改、商用。

但其實 public 只代表「看得到」，不代表「可以自由使用」。如果一個 repo 沒有清楚的 LICENSE，法律上就不一定代表別人可以任意複製、修改、散布或商用。

如果你希望別人可以使用你的程式碼，建議放上明確的授權條款，例如 MIT、Apache-2.0、GPL 等。如果你不希望別人使用，也不要因為放在 public repo 就以為大家自然會懂。

參考資料：Open Source Initiative：Licenses、SPDX License List

---

Repo 裡可以放大檔案嗎？

可以，但通常不建議把 repo 當成大型檔案倉庫。Git 很適合管理文字檔、程式碼、設定檔，但不適合管理大量影片、圖片、壓縮檔、資料庫檔案、模型權重。

如果 repo 裡有太多大檔案，會讓 clone、pull、push 都變得很慢，也可能遇到平台限制。GitHub 官方文件也建議 repository 盡量保持小型，必要時使用 Git LFS 或其他方式管理大型檔案。

如果你真的需要放大檔，可以考慮：

• Git LFS
• GitHub Releases
• 雲端儲存空間
• 資料集平台
• 物件儲存服務，例如 S3 類型服務

參考資料：GitHub 官方文件：About large files on GitHub

---

GitHub、GitLab、Bitbucket、Azure Repos 怎麼選？

如果你是新手，我會建議先從 GitHub 開始。原因很簡單：教學多、社群大、開源專案多、求職作品集也最常見。

但 GitHub 不是唯一選項。常見平台包括：

• GitHub：最適合新手、開源、作品集、一般團隊協作。
• GitLab：常見於重視 DevOps、CI/CD、自架與企業流程的團隊。
• Bitbucket：常見於使用 Jira、Confluence 等 Atlassian 工具的團隊。
• Azure Repos：常見於 Microsoft、Azure、企業內部開發環境。

如果你只是學習和放作品集，GitHub 通常最直覺。如果你是公司專案，則要考慮權限管理、CI/CD、資安要求、費用、資料治理、公司原本使用的工具，以及是否需要自架。

特別提醒，平台價格、免費額度、功能限制都會變動，不要只看舊文章。正式使用前，請回到官方 pricing 頁面確認。

參考資料：GitHub Pricing、GitLab Pricing、Bitbucket Pricing、Azure DevOps Pricing

---

新手最常犯的 Repo 錯誤

1. 把 repo 當雲端硬碟

Repo 可以放檔案，但它的重點不是單純存檔，而是版本控制與協作。如果你只是把所有資料亂丟進去，很快就會變成難以維護的資料夾。

2. 把密碼和 API key 上傳到 public repo

這是很嚴重的錯誤。API key、資料庫密碼、私鑰、token 都不應該放進 public repo。如果真的不小心上傳，請立刻撤銷金鑰，不要只刪掉檔案。

3. 沒有寫 README

沒有 README 的 repo，對陌生人來說幾乎很難理解。即使是自己的作品集，也應該寫清楚專案目的、安裝方式、使用方法與截圖。

4. 沒有 LICENSE

如果你希望專案被使用，請加上合適的授權。如果你不知道怎麼選，可以先查 GitHub 的授權說明或使用 choosealicense.com 這類工具。

參考資料：Choose an open source license

5. 直接在 main 上亂改

個人練習時也許沒問題，但團隊專案不建議這樣做。比較好的方式是開 branch、修改、commit、push，然後開 pull request。

6. Commit message 亂寫

像 test、update、final、fix 這類 commit message 雖然很常見，但不容易理解。比較好的寫法是讓人看得出你到底改了什麼。

例如：

• fix login form validation
• add product detail page
• update README setup instructions

7. 用 Star 數判斷 repo 品質

GitHub stars 可以代表人氣，但不一定代表品質。判斷一個 repo 是否值得參考，除了 stars，也要看：

• 最近是否還有更新
• issue 是否有人回覆
• README 是否清楚
• license 是否明確
• release 是否穩定
• 是否有安全政策

---

新手 Repo 避坑檢查清單

建立或公開 repo 前，可以用下面這份清單檢查一次。

• 是否有 README.md？
• README 是否說明專案用途、安裝方式與使用方式？
• 是否有合適的 .gitignore？
• 是否沒有把 .env、API key、密碼、token 上傳？
• 如果是 public repo，是否確認沒有公司機密或個資？
• 是否有 LICENSE？
• commit message 是否能看懂？
• 是否避免把大型檔案直接放進 Git？
• 是否知道 main branch 是正式版本，不要隨便亂改？
• 如果是團隊專案，是否使用 branch 和 pull request？

---

Repo 對台灣新手有什麼特別要注意？

如果只是個人學習，通常問題不大。但如果 repo 裡面牽涉公司資料、客戶資料、使用者資料、訂單資料、醫療資料、金融資料、政府專案資料，就要非常小心。

台灣個資法中，個人資料包含可以直接或間接識別自然人的資料。也就是說，不只是姓名、電話、Email 可能是個資，某些會員資料、交易資料、紀錄資料，也可能因為能識別特定人而需要更謹慎處理。

如果你在公司或接案環境中使用 GitHub、GitLab、Bitbucket 這類平台，最好先確認公司規範、客戶合約、資安政策與資料是否允許放到外部雲端 repo。

參考資料：全國法規資料庫：個人資料保護法

---

Repo 新手學習順序建議

如果你現在完全不熟 repo，不需要一開始就學所有 Git 指令。我會建議照下面順序學：

1. 先理解 repo 是什麼。
2. 再理解 Git 和 GitHub 的差別。
3. 接著學會 clone、add、commit、push、pull。
4. 再學 branch 和 pull request。
5. 補上 README、.gitignore、LICENSE。
6. 最後再學 CI/CD、GitHub Actions、branch protection、release、Git LFS。

新手最重要的不是把 Git 所有指令背起來，而是先建立正確觀念。只要你知道 repo 不是亂放檔案的地方，也知道如何安全地修改、提交、同步和協作，就已經比很多剛開始的人穩很多。

如果你想搭配 AI 程式助理一起練習，讓它幫你解釋指令、產生 commit 訊息或讀懂專案，也可以參考〈Claude Code 中文教學〉。

---

---

常見問題 FAQ

Repo 一定要用 GitHub 嗎？

不一定。GitHub 是很常見的平台，但你也可以使用 GitLab、Bitbucket、Azure Repos，甚至自架 Git 服務。只是對新手來說，GitHub 的教學資源最多，通常比較容易上手。

Public repo 會不會被別人偷走？

只要是 public repo，別人就能看到你的程式碼。但能不能合法使用，要看你的授權條款。如果你不希望別人看到，不要設成 public；如果你希望別人能用，請放清楚的 license。

我不會寫程式，也需要懂 repo 嗎？

如果你是 PM、設計師、技術寫作者、資料分析師，懂一點 repo 也很有幫助。你不一定要會寫很多 Git 指令，但至少要知道 README、issue、pull request、release、branch 是什麼，這能幫助你更順利和工程師合作。

如果你想用 AI 幫忙看程式或試著動手改，也可以從〈Codex AI 程式助理新手指南〉開始入門。

Repo 裡一定要有 README 嗎？

不一定是技術上強制，但實務上非常建議。README 是 repo 的入口說明，如果沒有 README，別人很難知道你的專案是什麼、怎麼使用、怎麼安裝。

我可以把整個電腦資料夾都放進 repo 嗎？

不建議。Repo 應該放和專案有關、需要版本控制的內容。像是暫存檔、密碼檔、大型影片、系統檔、依賴套件資料夾，通常不應該直接放進 repo。

GitHub stars 很多的 repo 就一定很好嗎？

不一定。Stars 可以代表人氣，但不代表安全、穩定、維護良好或授權清楚。使用別人的 repo 前，還是要看 README、license、issue、release、最近更新紀錄。

---

總結

Repo 是程式開發裡非常重要的基礎概念。它不只是放程式碼的地方，而是管理專案歷史、協作流程、文件、版本、權限與安全風險的核心。

如果你是新手，先不用急著學會所有 Git 指令。你可以先記住幾個重點：repo 是專案儲存庫，Git 是版本控制工具，GitHub 是雲端協作平台；commit 是紀錄修改，branch 是安全開發線，pull request 是讓別人檢查你的修改。

另外，請務必注意 README、.gitignore、LICENSE、API key、大檔案、public/private 這些基本細節。這些看起來不起眼，但它們往往決定一個 repo 是不是清楚、安全、專業，也決定別人能不能順利理解你的專案。