必知重點 1:首頁檔案要命名為 index.html
瀏覽器進入網站時,會自動尋找 index.html。
如果檔名錯了,就會出現 404 找不到頁面。
✅ 正確:index.html❌ 錯誤:home.html、main.html

必知重點 2:哪些檔案能放?哪些不能放?
GitHub Pages 只能放「靜態網頁」,這代表:HTML、CSS、JavaScript、圖片都可以,但 PHP、Node.js 等後端程式無法執行。
✅ 可以放的檔案
- HTML
- CSS
- JavaScript
- 圖片(JPG、PNG、SVG)
在 GitHub Pages 中,不是所有檔案都能成功被載入,以下整理給你:

❌ 不能放的檔案
- PHP
- Node.js
- 資料庫檔案(MySQL 等)
後端程式(例如 PHP、Node.js 等)在 GitHub Pages 上無法執行。

GitHub Pages 架網站實際設定步驟
接下來就帶你從 GitHub 設定 Pages,到最後看到作品上線!
Step 1:進入 Settings

Step 2:選擇 Pages

Step 3:設定來源分支
- 選擇 main
- 再選擇 / (root)
- 點選 Save

Step 4:切換到 Actions

Step 5:確認部署狀態
這裡會看到 pages build and deployment:
- 黃色 → 代表「還在上傳中」
- 綠色 → 代表「成功部署」

Step 6:點擊網址,檢查成果
部署完成後,系統會給你一個網址,點進去就能看到你的網頁啦!

Step 7:完成 🎉
你的 GitHub Pages 網頁正式上線啦!就是這麼簡單~~

GitHub Pages 架站常見問題 (FAQ)
1. GitHub Pages 一定要叫 index.html 嗎?
是的,首頁檔案務必命名為 index.html,因為瀏覽器會自動讀取這個檔案作為首頁。
2. 為什麼我上傳後還是 404?
可能原因:
- 檔案沒放在根目錄
/ - 檔名不是
index.html - GitHub Actions 還在跑,稍等幾分鐘
3. GitHub Pages 免費嗎?
完全免費,而且不限制瀏覽人次,非常適合個人作品集或小專案展示。
結論:用 GitHub Pages 免費架設個人網站
透過 GitHub Pages,你可以:
- 上傳作品集網站
- 分享個人履歷網頁
- 架設小型專案展示
整個過程不需要後端伺服器,操作簡單、快速,而且零成本。
只要照著步驟,你也能在幾分鐘內擁有屬於自己的網頁。
特別提醒兩個重要重點:
首頁檔案務必命名為 index.html,否則瀏覽器會出現 404。GitHub Pages 只能放靜態檔案(HTML、CSS、JavaScript、圖片等),後端程式無法執行。












