GitHub 完整課：初學 → 中階 → 高階

① 初學：申請 GitHub 帳號

1. 到 github.com/signup 註冊。
2. 啟用 2FA；設定帳號電郵與公開資料。
3. （可選）SSH key：Settings → SSH keys。

① 初學：Git 基礎指令

git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git clone https://github.com/OWNER/REPO.git
cd REPO
# 改檔後
git status
git add .
git commit -m "Describe change"
git push

官方：Get started · git-scm.com/doc

① 初學：建立 Repo 與 .gitignore

• New repository → 加 README → 複製 clone URL
• .gitignore 排除 .env、node_modules/、__pycache__/

② 中階：分支與 Pull Request

git checkout -b feature/my-change
# ... commit ...
git push -u origin feature/my-change
# 在 GitHub 開 Pull Request → Review → Merge

文件：Pull requests

② 中階：Issues、Projects、協作禮儀

• 用 Issue 記 bug／需求；PR 連結 Issue
• 小步提交、清楚訊息、回應 Review
• Fork → PR 到上游（開源貢獻）

③ 高階：GitHub Actions CI

# .github/workflows/ci.yml（概念範例）
name: ci
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: echo "run your tests here"

文件：GitHub Actions

③ 高階：安全與 Secrets

• Repo Settings → Secrets and variables → Actions
• Dependabot／代碼掃描（依方案）
• 文件：Code security

③ 高階：Pages、Copilot、與本站銜接

• GitHub Pages；本站 零成本建站
• Copilot／AI 編碼可搭配 Cursor、Claude Code
• 精選 AI repo：GitHub AI 工具教學

9. 把專案放到 GitHub（Push／發布）

學完初學 Git 後，用這套步驟把本機專案公開（或私有）上架。

方法 A｜本機已有資料夾（最常見）

1. 在 GitHub 按 New repository：填名、選 Public／Private、先不要勾 Initialize README（若本機已有檔案）。
2. 本機進入專案資料夾，確認有 .gitignore（排除 .env、金鑰、依賴目錄）。
3. 初始化並推送：

cd /path/to/your-project
git init
git add .
git status   # 確認沒有 .env / 金鑰
git commit -m "Initial commit: describe your project"
git branch -M main
git remote add origin https://github.com/YOUR_USER/YOUR_REPO.git
git push -u origin main

SSH 使用者可把 remote 改成 git@github.com:YOUR_USER/YOUR_REPO.git。

方法 B｜用 GitHub CLI

# 需先安裝 gh 並 gh auth login
cd /path/to/your-project
git init && git add . && git commit -m "Initial commit"
gh repo create YOUR_REPO --public --source=. --remote=origin --push

方法 C｜先在網頁建空庫再 clone

1. New repository 可勾 README → Clone 到本機 → 把專案檔案複製進去 → add／commit／push。

發布檢查清單

• 寫清楚 README.md：做什麼、怎麼安裝／跑、授權。
• 選 License（MIT／Apache-2.0 等）；開源前確認沒有他人私有程式碼。
• 敏感檔用 Secrets／環境變數；掃一遍勿已推送金鑰。
• 可選：開 GitHub Pages 或接 零成本建站 展示 Demo。
• 之後改動：git add → commit → git push；協作改走 PR（見中階課節）。

官方：Adding locally hosted code to GitHub · GitHub CLI

連結總表