用 Astro + GitHub Pages 免費架自己的網站

初稿由 Claude 整理自建站過程，待 00 復盤補充自己的心得。

思路

想要一個完全屬於自己的網頁，放作品集、分享和筆記。需求排序是：免費、內容好維護、可以玩特效。最後選了：

• GitHub Pages：免費靜態網頁託管，網址就是 帳號名.github.io。
• Astro：靜態網站產生器（Static Site Generator）。文章寫成 Markdown 檔丟進資料夾，就自動長出頁面——以後新增一篇分享只要加一個 .md 檔。
• GitHub Actions：每次 push 程式碼就自動建置、部署，不用手動操作。

遇到的困難

• GitHub Pages 的部署模式：主站 repo 一建立，GitHub 會自動用舊式「直接把檔案當網頁」模式部署，要手動切換成 workflow 模式，Astro 的建置結果才會生效。
• Token 權限：用 GitHub CLI 推送含有 Actions 設定檔的程式碼，需要 workflow 權限，得重新授權一次。
• 帳號放錯：一開始把 repo 建在錯的帳號底下，整個搬家一次——repo 名稱必須等於帳號名稱，這是主站的硬規則。

學到的事

• 靜態網站（沒有後端伺服器）能做的事比想像中多：動畫、互動、文章系統都行，而且免費、快、安全。
• 「內容」與「版型」分離是關鍵：Markdown 管內容、元件管長相，之後改版型不用動文章。
• 跟 AI 協作時，先把架構和驗收點談清楚（垂直切片、每階段確認），比一口氣做完再改省力得多。