適合:用 Astro 寫部落格的人、想把網站放上 Cloudflare 的前端開發者
用 Astro 架部落格
用 Astro 寫部落格,文章一多就開始卡:建置變慢、搜尋找不到、部署上去又出錯。這裡整理了加快建置、補齊部落格功能、選平台上線到安心升級的做法,照著讀可以少踩不少坑。
文章變多,建置越來越慢?
先搞清楚文章怎麼被讀進來、資料存在哪裡,再讓沒變動的頁面跳過重建。
- 1. 用 glob() 建立可驗證的內容集合
Astro Content Loader 怎麼用:用 glob() 建立可驗證的本機內容集合
Astro glob() 的 retainBody: false 只移除原始本文,不代表 Markdown 無法渲染。本文整理 base、pattern 與 schema 的範圍,提供隔離專案的建置斷言,分開驗收 entry.body、rendered.html 與 render(entry),避免誤判儲存選項。
- 2. 拆分過大的內容資料
Astro Content Collection 太大怎麼辦?用 collectionStorage 分塊儲存
Astro Content Collection 產生過大的 .astro/data-store.json 時,本文說明 experimental collectionStorage 的 chunked 設定、20 MB 預設分塊、chunkSize 與部署產物驗證,避免只改設定卻漏掉 adapter。
- 3. 跳過沒有變動的頁面
Astro incremental build 怎麼用?用 incrementalBuild 與 cacheKey 減少重建
Astro 7.2 的 experimental incremental build 可跳過程式碼與資料未變的 prerendered pages。本文示範 incrementalBuild、cacheKey、CI cache 與失效檢查。
- 4. 在背景管理本機預覽
Astro preview --background 怎麼用?用 status、logs、stop 管理本機預覽
Astro 7.2.0 新增 preview --background,可在背景啟動預覽並用 status、logs、stop 管理。本文整理版本檢查、build 順序、CI 清理與自動背景模式的邊界。
部落格該有的功能怎麼補?
延伸閱讀、站內搜尋、sitemap、程式碼複製按鈕,讀者天天會用到,也影響搜尋引擎怎麼看你的網站。
- 5. 自動產生延伸閱讀
在 Astro 部落格實作自動延伸閱讀
在 Astro 部落格自動產生延伸閱讀:以 tags 與 category 排序,必要時用 frontmatter 指定關聯文章。本文釐清批次兩兩比較的實際複雜度,並說明如何以本機建置時間驗證是否需要優化。
- 6. 輸出 Schema 結構化資料
在 Astro 部落格自動生成 Schema 結構化資料
讓 Astro 部落格自動產生 BlogPosting、FAQ、HowTo、Breadcrumb 等 Schema 結構化資料,提升 SEO 搜尋結果呈現效果。
- 7. 排除不該送出的路徑
Astro Sitemap 設定:如何排除 noindex、分頁與不該送出的路徑
Astro 的 sitemap 整合會在建置時產生 XML。本文用實際 filter 範例說明 site 設定、sitemap-index.xml、robots.txt,以及 noindex 與分頁路徑該如何處理。
- 8. 只複製程式碼的按鈕
Astro 程式碼區塊複製按鈕:用 Expressive Code 保留程式碼與行號
Astro Markdown 程式碼區塊的複製按鈕要只複製程式碼,並在剪貼簿寫入成功後才回報完成。本文以 Expressive Code 渲染 hook 和事件委派處理 SVG 點擊、連續操作、權限拒絕與換頁驗收,區分示意改良與現有實作,避免假成功或重複綁定。
- 9. 決定哪些內容進搜尋索引
Pagefind 怎麼排除不該搜尋的內容?data-pagefind-ignore 與 exclude_selectors
Pagefind 預設會從頁面 body 建立搜尋索引,但導覽列、分享工具、重複標題或輔助文字不一定適合被搜尋。本文整理 data-pagefind-body、data-pagefind-ignore、exclude_selectors 的差異,並用 Astro build 與 dist 檢查實際索引邊界。
- 10. 限制遠端圖片的來源
Astro 遠端圖片怎麼設白名單:用 domains 與 remotePatterns 縮小來源範圍
Astro 使用遠端圖片時,別用過寬的來源設定。本文整理 image.domains 與 image.remotePatterns 的差異、何時限制 HTTPS host 與路徑,以及如何驗證圖片最佳化和版面穩定。
上線前,安全設定檢查了嗎?
確認沒把金鑰打包進前端,CSP 也先觀察一陣子再收緊,免得網站突然壞掉。
- 11. 找出誤放進 bundle 的 secret
Vite 的 VITE_ 環境變數會外洩嗎?從 bundle 找出不該公開的 secret
Vite 會在建置時把 VITE_ 變數送進前端 bundle。本文整理公開設定與 API secret 的分界、dist 檢查、envPrefix 調整,以及外洩後的輪替與重新部署流程,避免修正後仍部署舊資產。
- 12. 用 Report-Only 漸進收緊 CSP
Astro CSP 設定 inline script 與 style 前,先用 Report-Only 找出阻擋
Astro 7.1 新增更細的 CSP directive 控制。本文整理部署靜態網站前,如何以 Report-Only、實際資源清單與漸進收緊方式避免 inline script 或 style 被誤擋。
- 13. 在請求管線加入前後置邏輯
Astro Advanced Routing 怎麼用?用 src/fetch.ts 插入請求管線
Astro 7 的 Advanced Routing 會把 src/fetch.ts 當成請求管線入口。本文用 astro/fetch 示範保留內建路由、加入前後置邏輯、改名 fetchFile 與停用入口,並整理升級時的保留檔名風險。
網站要放在哪裡?
純靜態網站和需要伺服器的網站,適合的平台不一樣。先看清楚限制,上線後再逐項確認。
- 14. 比較 Cloudflare Pages 與 Workers
Cloudflare Pages 的 Astro 檔案數超過怎麼辦?先分清 Pages 與 Workers
Astro 部署到 Cloudflare Pages 失敗時,先計算 dist 檔案數與單檔大小,再比較 Free、付費 Pages 和 Workers Static Assets。本文也說明純靜態、SSR 與 bindings 的選擇邊界。
- 15. 關掉用不到的 SESSION KV
Astro Cloudflare 為什麼有 SESSION KV?用 session: false 關掉不需要的狀態
使用 @astrojs/cloudflare 部署 Astro 時,為什麼會看到 SESSION KV binding?本文說明 adapter 預設行為、Astro 7.2.0 的 session: false、sessionKVBindingName 與 Astro.session 的取捨,並整理部署驗證。
- 16. 驗收其他平台的部署與備份
Spacefast 部署 Astro 前:靜態、SSR、分享與資料匯出怎麼驗收?
Spacefast 部署 Astro 時,先分清上傳 dist 和需要伺服器執行的 SSR。從同一份 Git commit 驗證深層網址與分享權限,再分開保存原始碼、資料庫匯出和網域設定,避免把站台版本回復當成完整備份,也能提早看出遷移時要重做哪些部分。
- 17. 發布給 AI 代理讀取的 poppy.json
Astro 網站怎麼放 poppy.json?Poppy 1.0 探索路徑與網域驗收
在 Astro 網站發布 Poppy 1.0 的 poppy.json,可以先用靜態網站入口支援未登入瀏覽。本文示範最小檔案與建置路徑,說明上線後怎麼檢查 HTTPS、重新導向的最終網址、實際回應的 JSON,以及主機名稱是否符合規格。
要升級了,怎麼避免出事?
先讀懂這次改了什麼,在本機跑過一輪再升。想換主題或 CMS,也先小範圍試試。
- 18. 檢查 Astro 7 的升級回歸
Astro 7.4.11 升級檢查:SSR 代理、Node.js 門檻與建置回歸
Astro 7.4.11 調整 SSR 對反向代理轉送標頭的驗證。升級時先用 staging 檢查外部網址、重新導向與登入回呼,再核對 7.4.2 起的 Node.js 門檻。本文保留 Astro 6 到 7 的 Vite、內容與互動元件遷移清單。
- 19. 排查 Vite 依賴預先打包錯誤
Vite 出現 error while updating dependencies 怎麼修?先查快取與 linked package
Vite 顯示 error while updating dependencies 時,先查 dev 預先打包、node_modules/.vite 與 linked package;Vite 8.3.1 也修正一種依賴掃描漏項。本文提供分層排查流程。
- 20. 升級 Starlight 文件站
Starlight 0.42 升級要檢查什麼?Popover、JavaScript 與 sidebar
Starlight 0.42 改用 Popover API 處理行動版選單,並改以編譯後 JavaScript 與型別定義發布。本文整理升級指令、sidebar、無 JavaScript、可及性與 Astro build 回歸檢查。
- 21. 評估是否改用 EmDash CMS
EmDash 1.0 適合 Astro 部落格嗎?導入前檢查表
EmDash 1.0 是建立在 Astro 上的 CMS,能否取代 Markdown 文章庫要看內容由誰維護、頁面如何更新與部署環境。這份檢查表整理兩種 collection 共存方式、SSR 限制、外掛沙箱與小規模試行步驟。