實作文章
Cursor + Astro 點 30 分鐘上線？（GitHub + Cloudflare Pages 實作）
如果你想快速有一個屬於自己嘅技術 blog，最短路徑其實唔複雜：
Cursor 寫內容 → Astro 生成網站 → GitHub 保存版本 → Cloudflare Pages 自動發佈。
呢篇用「最小可行流程」帶你由 0 到上線；
唔使背指令，你可以用 Cursor 對話完成大部分操作，只需要識得喺網頁後台撳幾個掣。
先講結論（你只需要做 4 件事）
- 建立 Astro blog 專案（可用 Cursor 幫手）
- 把文章放入
src/content/blog - 上傳到 GitHub（當雲端資料夾 + 版本紀錄）
- 喺 Cloudflare Pages 連接 GitHub，設定好 3 個部署選項
第一次目標唔係靚，而係成功見到 live 網址；靚化可以之後慢慢做。
開始前準備（10 分鐘內搞掂）
請先準備：
- Cursor（寫文、改檔、預覽）
- GitHub 帳號（存放專案）
- Cloudflare 帳號（免費 Pages 已夠起步）
- （可選）已購買網域；未有都可以先用測試網址上線
角色分工（一人做晒都得）：
你負責內容同檔案；GitHub 負責「保存」；Cloudflare 負責「每次改完自動出街」。
Step 1：建立 Astro blog 專案
做法 A：用 Cursor 幫你建立（推薦新手）
- 喺 Cursor 開新資料夾（例如
my-tech-blog） - 喺對話框輸入類似請求：
請用 Astro 最新 blog 模板幫我建立專案，要支援 Markdown 文章目錄，並教我點預覽。
- 跟住 Cursor 提示完成安裝；若佢建議你執行指令，可以喺 Cursor 內建終端複製貼上執行一次
- 當 Cursor 話可以預覽，用瀏覽器打開佢俾你嘅本地網址（通常類似
http://localhost:4321） - 見到預設 blog 頁就代表基礎 OK
做法 B：自己用官方建立工具
若你熟悉一點，亦可跟 Astro 官網「Create project」指引；
揀 blog template。完成後同樣要確認本地預覽打得開。
驗收： 首頁同 /blog 列表頁可以開，冇明顯錯誤。
Step 2：新增第一篇文章
文章放喺邊？
把所有文章放在：
src/content/blog/
每篇一個檔案，副檔名 .md 或 .mdx 都可以（視乎你專案設定）。
文章頂部最少要寫咩？
每篇 Markdown 最上面要有設定區（frontmatter），最少包括：
---
title: 我的第一篇文章
description: 用一句話講這篇講乜
pubDate: 2026-04-22
---正文由 --- 下面開始寫；唔好再寫一個同 title 一樣嘅超大標題。
若漏欄位，之後 Cloudflare 部署時可能會建置失敗；所以建議跟《非工程背景點管理 Astro 文章》嘅檢查清單。
用 Cursor 寫文會快啲
- 複製現成文章改（最穩）
- 叫 Cursor：「跟住呢篇格式，幫我寫一篇關於 XXX 的教學文，粵語書面，先結論後步驟」
- 寫完用預覽確認排版
Step 3：上傳到 GitHub
你可以把 GitHub 想像成帶版本紀錄嘅雲端資料夾；Cloudflare 會由呢度拉最新檔案去建置。
做法 A：用 Cursor 內建 Git（較直觀）
- 喺 GitHub 網頁 New repository 建立空 repo（例如
my-tech-blog） - 回到 Cursor，開 Source Control（版本控制）面板
- Initialize repository → 填寫第一次說明（例如
init astro blog）→ Commit - 按 Publish Branch 或 Add Remote，連去你剛建立嘅 GitHub repo
- Push 完成後，去 GitHub 網頁確認檔案已經出現
做法 B：用 GitHub Desktop（完全唔想見指令）
- 安裝 GitHub Desktop
- Add existing repository → 揀你嘅 Astro 資料夾
- Commit → Publish repository
之後每次改文： 改檔 → Commit（寫一句你改咗咩）→ Push。
Cloudflare 會自動再部署（通常 1 至 3 分鐘）。
Step 4：Cloudflare Pages 部署（跟畫面做）
- 登入 Cloudflare → Workers & Pages
- Create → Pages → Connect to Git
- 授權並揀你剛才嘅 GitHub repo
- 填寫建置設定（最易錯，請逐項對）：
| 欄位 | 一般填咩 |
|---|---|
| Build command | npm run build |
| Output directory | dist |
| Root directory | Astro 若在子資料夾就填該資料夾名；在 repo 根目錄就留空 |
- 按 Save and Deploy，等狀態變 Success
- 你會先得到一個
*.pages.dev測試網址；用手機同電腦各開一次確認
綁你自己嘅網域（可之後再做）
測試網址確認無問題後，再到 Custom domains 加網域。
詳細清單跟《Cloudflare Pages 綁自訂網域要檢查乜》。
常見錯誤（最容易中伏）
1）搵唔到 package.json（ENOENT）
- 原因： Root directory（專案路徑）填錯
- 解法： 去 GitHub 睇
package.json喺邊一層，Cloudflare 就指向同一層 - 延伸閱讀： 《Cloudflare Pages 部署錯誤 5 個高頻問題》
2）文章顯示唔到或部署失敗
- 原因： 文章頂部設定漏
title/description/pubDate，或日期格式唔啱 - 解法： 打開部署紀錄指名嗰篇檔案，補齊欄位再 Push
3）Build 過咗但網址唔係自己網域
- 原因： 未綁 custom domain；呢步正常
- 解法： 先用測試網址驗收內容，再綁網域
點樣知自己真係成功？
- 本地預覽或建置無錯
- Cloudflare 最新一次 Deployment 顯示 Success
-
/blog列表見到新文章 - 測試網址用手機、電腦都開到
- （如有網域）
https有鎖頭、主要頁正常
咩嘢情況下建議搵人睇一次？
下面呢篇係通用教學；如果你符合其中一兩項，用 30 分鐘診斷對一次現況，通常會快過自己試錯堆砌設定。
- 你跟過文內步驟，仍然困喺同一個錯誤迴圈，而且已經用咗預期以外嘅時間（例如超過一個工作天）。
- 牽涉多個帳戶、DNS、寄信驗證（SPF／DKIM）或幾個服務交界，你想一次過排好優先次序同風險。
- 你想將做法接到實際業務流程（表單、名單、漏斗），而唔止係跟住教學跑通 demo。
常見搜尋問法
- 真係 30 分鐘可以上線嗎？
第一版可以，前提係跟最小流程完成一次成功部署，唔追求一步到位美化。 - 新手最常卡邊一步？
多數係 Cloudflare 專案路徑設錯，令建置搵唔到package.json。 - 上線後先做乜最值回票價？
固定出文節奏同每篇一個明確 CTA，比即刻大改設計更影響搜尋同轉化。 - Cursor 喺邊度最有用？
建立專案、寫文、檢查 frontmatter、批量改字眼同語氣統一。
建議閱讀順序（同系列）
- 本文：先上線
- 《非工程背景點管理 Astro 文章》：固定出文流程
- 《Cloudflare Pages 部署錯誤 5 個高頻問題》：部署卡住時查
- 《Cloudflare Pages 綁自訂網域清單》：由測試網址轉正式網域
- 《AEO 實作指南》：內容結構升級
下一步
上線第一日唔好追求完美 UI：先固定每週出文節奏、每篇一個明確 CTA，再用 Search Console／Analytics 睇表現；穩定輸出先再升級設計。
常見問題 FAQ
我一定要先有 Astro 經驗先做到 30 分鐘上線嗎？
唔需要。照住最小流程做，先成功部署一次，再慢慢優化結構同設計。
最常見會卡住邊一步？
通常係 Cloudflare 專案路徑（Root directory）設定錯，導致建置搵唔到 package.json。
上線後第一件最值得做咩？
先固定出文節奏，因為持續輸出對流量同搜尋表現影響遠大過一次性美化。
About me
你好，我係阿丸。呢度以數位主權為核心，分享點樣用 AI 幫手整網頁、建立吸客贈品頁、整理內容同上線作品， 目標係幫你用更短時間把內容同網站做成可帶走、可維護嘅自有資產。
我會持續更新可跟做嘅教學、踩坑記錄同流程模板，等你唔使被平台黑盒綁死，亦唔使再由零重複試錯。
同時呢度會多寫一人公司最常遇到嘅訂閱制現實：工具加價、用量隱形成本、平台綁定風險， 同埋點樣用可執行嘅做法，將名單、主站同漏斗慢慢揸返喺自己手度。
你會見到嘅內容包括：支出檢視框架、用量上限與警報、搬遷前準備同主權策略；目標唔係一夜換晒工具， 而係先止血，再建立長期可維護嘅自有資產。
想先攞可跟做模板同檢查清單？
先由免費吸客贈品包開始，將文章做法變成你可即用嘅落地清單，再按需要對照服務範圍安排下一步。
想睇合作模式同交付範圍，可先睇服務與合作方式。