第一次接觸 GitHub,往往會卡在幾個關卡:帳號怎麼開、倉庫怎麼建、SSH Key 怎麼配、本機的專案又怎麼推上去。這篇文章把整個流程拆成四個階段,跟著做完,你就擁有一個屬於自己的遠端倉庫了。
先開啟官方網站 https://github.com 完成註冊。

填完表單送出後,畫面會引導你選擇帳號方案,接著往下走即可。

註冊完成後,GitHub 會寄一封驗證信到你的信箱,記得點進信中的連結完成信箱驗證,往後才能正常使用各項功能。
信箱驗證通過後,點擊頁面上的綠色按鈕就可以開始建立倉庫(Repository)。


另一條路徑是從右上角頭像進入個人頁面,在 Repositories 分頁裡點 New。



倉庫建立完成後,畫面會長得像這樣。這裡有個小提醒:倉庫名稱盡量不要用中文,否則在部分環境下名稱會被轉成小數點式的顯示,看起來就是一段短橫線,辨識度很差。授權條款(License)的選項則在頁面下方,依專案性質挑選即可。

要用 SSH 方式推送程式碼,得先讓本機擁有一組金鑰。預設情況下 macOS 的 Finder 不顯示隱藏檔,我們可以透過終端機打開這個開關:
# 顯示隱藏檔案 defaults write com.apple.finder AppleShowAllFiles -bool true # 還原(改回 false) defaults write com.apple.finder AppleShowAllFiles -bool false
指令執行完畢後要重啟 Finder 才會生效:點左上角蘋果 logo → 強制退出 → 選取 Finder → 重新啟動。

接著打開個人目錄,檢查有沒有 .ssh 資料夾。如果曾經設定過但已不再使用,建議先刪掉重新來過,避免金鑰衝突。

在終端機依序執行下列指令,建立資料夾並產生金鑰(雙引號內換成你自己的註冊信箱):
mkdir .ssh cd .ssh ssh-keygen -t rsa -C "youEmail"
過程中會詢問儲存位置與通行密碼,直接連續按 Enter 使用預設值即可,直到出現金鑰產生的提示。

用 ls -la 確認檔案已生成,看到 id_rsa 與 id_rsa.pub 一組檔案就代表成功。

把公鑰複製到剪貼簿:
pbcopy < ~/.ssh/id_rsa.pub
回到 GitHub,進入 Settings → SSH and GPG keys 頁面。

點 New SSH key,把剛剛複製的內容貼上並儲存。


新增成功後,列表裡會多出一筆金鑰紀錄。

最後在終端機驗證連線,出現是否繼續連線的詢問時輸入 yes 並按下 Enter:
ssh -T git@github.com
回到 GitHub 重新整理網頁,你會發現金鑰旁邊原本灰色的小圓點變成綠色,代表設定完全成功。

如果不想跟指令稿纏鬥,可以直接用官方桌面客戶端,下載網址:https://desktop.github.com。安裝後輸入帳號密碼登入,接著把剛剛建立的倉庫 clone 回本機。

打開 clone 下來的資料夾(以下以 FirstRespository 為例),把要上傳的專案檔案全部放進去。

檔案放好後切回 GitHub 客戶端,它會自動偵測到新增的檔案。

在左下角填寫摘要與說明,然後點擊右上角的 Commit 按鈕。

提交完成後,畫面會顯示這次的提交紀錄。

最後點擊 Sync 或 Push 把本地的提交同步到遠端,重新整理 GitHub 網頁,就能看到你的程式碼已經躺在倉庫裡了。恭喜,你已經成功建立並推送了第一個屬於自己的 GitHub 倉庫。