Git 與 GitHub 入門實戰：從帳號申請到專案推送完整流程

本教學以最精簡步驟，引導您完成 GitHub 帳號建立、SSH 金鑰配置、Git 全域設定、本地倉庫初始化、首次推送與後續更新的完整閉環。適合零基礎開發者快速上手。

前置準備

1. 申請 GitHub 帳號（例：xxx）
2. 在 GitHub 建立新 Repository：new-project
3. 安裝 Git 客戶端（Linux）：sudo yum install git git-gui 或 sudo apt install git

SSH 金鑰配置（免密推送關鍵）

# 1. 產生 RSA 金鑰對（附帶 Email 當註解）
ssh-keygen -t rsa -C "xxx@gmail.com"
# 一路 Enter 使用預設路徑 ~/.ssh/id_rsa

# 2. 將公鑰內容貼到 GitHub Settings → SSH and GPG keys → New SSH key
cat ~/.ssh/id_rsa.pub

# 3. 啟動 ssh-agent 並加入私鑰（避免每次輸入 passphrase）
eval `ssh-agent`
ssh-add
# 輸入 passphrase（若設定過）

# 4. 測試連線
ssh git@github.com
# 成功顯示：Hi xxx! You've successfully authenticated...

Git 全域身分設定

git config --global user.name "xxx"
git config --global user.email xxx@gmail.com

建立本地專案並首次推送

# 1. 建立工作目錄並初始化
mkdir new-project && cd new-project
git init

# 2. 建立第一個檔案並提交
touch README
git add README
git commit -m 'first commit'

# 3. 關聯遠端倉庫（別名 origin）
git remote add origin git@github.com:xxx/new-project.git

# 4. 推送至遠端（-u 設定上游追蹤）
git push -u origin master

完成後，瀏覽 https://github.com/xxx/new-project 即可看到專案。

日常更新流程

# 1. 修改檔案
vi README

# 2. 暫存所有變更並提交（-a 自動偵測修改/刪除）
git commit -a -m 'update readme'

# 3. 推送至遠端
git push origin master

常見問題快速排查

進階小技巧

• 多帳號切換： 使用 ~/.ssh/config 設定不同 Host 對應不同 Key
• GPG 簽名提交： git config --global commit.gpgsign true 提升可信度
• 別名加速： git config --global alias.st status、alias.co checkout、alias.br branch

掌握這套標準流程，您已具備獨立或團隊協作開發的 Git 基礎能力。後續可深入學習分支策略、Rebase、Cherry-pick 等進階技巧。