Cursor + Astro：30 分鐘上線流程（GitHub + Cloudflare Pages）
如果你想快速有一個屬於自己嘅技術 blog，最短路徑其實唔複雜：
Cursor 寫內容、Astro 出站、GitHub 管版本、Cloudflare Pages 發佈。
呢篇就用「最小可行流程」帶你由 0 到上線。
先講結論（你要做嘅只係 4 步）
- 建 Astro 專案
- 放文章去
src/content/blog - 推上 GitHub
- 喺 Cloudflare Pages 連 repo 部署
Step 1：建立 Astro blog 專案
喺本機跑：
npm create astro@latest揀 blog template，完成後進入專案：
npm install
npm run dev開到本地預覽就代表基礎 OK。
Step 2：新增文章
將文章放入：
src/content/blog/
每篇 .md 最少要有 frontmatter：
---
title: 文章標題
description: 文章描述
pubDate: 2026-04-22
---無呢幾個欄位，Astro content schema 可能會報錯。
Step 3：推上 GitHub
git init
git add .
git commit -m "init astro blog"
git branch -M main
git remote add origin https://github.com/<your-account>/<your-repo>.git
git push -u origin main之後每次改文只要：
git add .
git commit -m "add new post"
git pushStep 4：Cloudflare Pages 部署
去 Cloudflare：
- Workers & Pages -> Create -> Pages -> Connect to Git
- 揀你個 GitHub repo
- Build 設定：
- Build command:
npm run build - Output directory:
dist - Root directory: 如果 Astro 唔喺 repo 根目錄，要填對應子資料夾
- Build command:
部署成功後，你會先得到一個 *.workers.dev 測試網址，再綁自訂網域。
常見錯誤（最容易中伏）
1) ENOENT package.json
多數係 Root directory 填錯。
Cloudflare 喺錯路徑跑 build，自然搵唔到 package.json。
2) 文章顯示唔到
通常係 frontmatter 欄位唔齊，或日期格式錯。
3) Build 過咗但網址唔啱
你見到 workers.dev 係正常預設網域，未綁 custom domain 之前都係呢個。
驗證你有冇成功
- 本地
npm run build無錯 - Cloudflare Deployment 顯示 Success
/blog文章列表見到新文- 自訂網域可正常打開（可等 DNS/SSL 傳播）
下一步（建議）
上線第一日唔好追求完美 UI，先做三件事：
- 固定每週出文節奏
- 每篇文設一個明確 CTA
- 用 Search Console/Analytics 睇文章表現
先有穩定輸出，再做設計升級，長遠效果會好過一開始砌到好靚但無更新。
常見問題 FAQ
我一定要先有 Astro 經驗先做到 30 分鐘上線嗎？
唔需要。照住最小流程做，先成功部署一次，再慢慢優化結構同設計。
最常見會卡住邊一步？
通常係 Cloudflare Root directory 設定錯，導致 build 搵唔到 package.json。
上線後第一件最值得做咩？
先固定出文節奏，因為持續輸出對流量同搜尋表現影響遠大過一次性美化。
About me
你好，我係 YouOwnClub。呢度專注分享 Astro、Cloudflare Pages、WordPress 遷移同 AI 寫碼工作流，目標係幫你用更短時間把內容同網站真正上線。
我會持續更新可跟做嘅教學、踩坑記錄同流程模板，等你唔使再由零重複試錯。
想加快你嘅建站與發佈流程？
如果你想用 Astro + Cloudflare Pages 快速上線，或者想整理你嘅 AI 寫碼工作流，歡迎睇埋其他實作文章。