GitHub 作品集與 Portfolio 建置指南

這個指南怎麼用

兩組文章對應兩個不同的階段：第一組處理「單一專案怎麼讓人看懂」—— README、commit 紀錄、專案本身的整理；第二組處理「把多個專案整合成一份作品集」—— Portfolio 架構、個人網站、成果怎麼呈現。

如果你手上已經有專案但 GitHub 看起來一片空白，先讀第一組； 如果你有好幾個散落的成果、想要一個能一次傳出去的連結，直接看第二組。

評審實際上會看什麼

要先講清楚一件事：多數招生委員不會逐行讀你的程式碼，其中有些人根本不是技術背景。 他們能在短時間內判斷的，其實是幾個間接訊號：

• README 說不說得清楚——這是什麼、為什麼做、怎麼用、成果是什麼。它幾乎是專案唯一的第一印象。
• commit 紀錄長什麼樣——是一路累積的開發過程，還是最後一天把所有檔案一次上傳。
• 專案之間有沒有方向——三個指向同一個興趣的小專案，比十個互不相干的作業更有說服力。

這三件事都不需要高深技術，但都需要時間，臨時補不出來——那也正是它們有鑑別度的原因。

GitHub 作品集：怎麼讓評審看懂你做了什麼

個人網站與 Portfolio：把作品集整合起來