Stage 01

文章變多,建置越來越慢?

先搞清楚文章怎麼被讀進來、資料存在哪裡,再讓沒變動的頁面跳過重建。

  1. 1. 用 glob() 建立可驗證的內容集合

    Astro Content Loader 怎麼用:用 glob() 建立可驗證的本機內容集合

    Astro glob() 的 retainBody: false 只移除原始本文,不代表 Markdown 無法渲染。本文整理 base、pattern 與 schema 的範圍,提供隔離專案的建置斷言,分開驗收 entry.body、rendered.html 與 render(entry),避免誤判儲存選項。

  2. 2. 拆分過大的內容資料

    Astro Content Collection 太大怎麼辦?用 collectionStorage 分塊儲存

    Astro Content Collection 產生過大的 .astro/data-store.json 時,本文說明 experimental collectionStorage 的 chunked 設定、20 MB 預設分塊、chunkSize 與部署產物驗證,避免只改設定卻漏掉 adapter。

  3. 3. 跳過沒有變動的頁面

    Astro incremental build 怎麼用?用 incrementalBuild 與 cacheKey 減少重建

    Astro 7.2 的 experimental incremental build 可跳過程式碼與資料未變的 prerendered pages。本文示範 incrementalBuild、cacheKey、CI cache 與失效檢查。

  4. 4. 在背景管理本機預覽

    Astro preview --background 怎麼用?用 status、logs、stop 管理本機預覽

    Astro 7.2.0 新增 preview --background,可在背景啟動預覽並用 status、logs、stop 管理。本文整理版本檢查、build 順序、CI 清理與自動背景模式的邊界。

Stage 02

部落格該有的功能怎麼補?

延伸閱讀、站內搜尋、sitemap、程式碼複製按鈕,讀者天天會用到,也影響搜尋引擎怎麼看你的網站。

  1. 5. 自動產生延伸閱讀

    在 Astro 部落格實作自動延伸閱讀

    在 Astro 部落格自動產生延伸閱讀:以 tags 與 category 排序,必要時用 frontmatter 指定關聯文章。本文釐清批次兩兩比較的實際複雜度,並說明如何以本機建置時間驗證是否需要優化。

  2. 6. 輸出 Schema 結構化資料

    在 Astro 部落格自動生成 Schema 結構化資料

    讓 Astro 部落格自動產生 BlogPosting、FAQ、HowTo、Breadcrumb 等 Schema 結構化資料,提升 SEO 搜尋結果呈現效果。

  3. 7. 排除不該送出的路徑

    Astro Sitemap 設定:如何排除 noindex、分頁與不該送出的路徑

    Astro 的 sitemap 整合會在建置時產生 XML。本文用實際 filter 範例說明 site 設定、sitemap-index.xml、robots.txt,以及 noindex 與分頁路徑該如何處理。

  4. 8. 只複製程式碼的按鈕

    Astro 程式碼區塊複製按鈕:用 Expressive Code 保留程式碼與行號

    Astro Markdown 程式碼區塊的複製按鈕要只複製程式碼,並在剪貼簿寫入成功後才回報完成。本文以 Expressive Code 渲染 hook 和事件委派處理 SVG 點擊、連續操作、權限拒絕與換頁驗收,區分示意改良與現有實作,避免假成功或重複綁定。

  5. 9. 決定哪些內容進搜尋索引

    Pagefind 怎麼排除不該搜尋的內容?data-pagefind-ignore 與 exclude_selectors

    Pagefind 預設會從頁面 body 建立搜尋索引,但導覽列、分享工具、重複標題或輔助文字不一定適合被搜尋。本文整理 data-pagefind-body、data-pagefind-ignore、exclude_selectors 的差異,並用 Astro build 與 dist 檢查實際索引邊界。

  6. 10. 限制遠端圖片的來源

    Astro 遠端圖片怎麼設白名單:用 domains 與 remotePatterns 縮小來源範圍

    Astro 使用遠端圖片時,別用過寬的來源設定。本文整理 image.domains 與 image.remotePatterns 的差異、何時限制 HTTPS host 與路徑,以及如何驗證圖片最佳化和版面穩定。

Stage 03

上線前,安全設定檢查了嗎?

確認沒把金鑰打包進前端,CSP 也先觀察一陣子再收緊,免得網站突然壞掉。

  1. 11. 找出誤放進 bundle 的 secret

    Vite 的 VITE_ 環境變數會外洩嗎?從 bundle 找出不該公開的 secret

    Vite 會在建置時把 VITE_ 變數送進前端 bundle。本文整理公開設定與 API secret 的分界、dist 檢查、envPrefix 調整,以及外洩後的輪替與重新部署流程,避免修正後仍部署舊資產。

  2. 12. 用 Report-Only 漸進收緊 CSP

    Astro CSP 設定 inline script 與 style 前,先用 Report-Only 找出阻擋

    Astro 7.1 新增更細的 CSP directive 控制。本文整理部署靜態網站前,如何以 Report-Only、實際資源清單與漸進收緊方式避免 inline script 或 style 被誤擋。

  3. 13. 在請求管線加入前後置邏輯

    Astro Advanced Routing 怎麼用?用 src/fetch.ts 插入請求管線

    Astro 7 的 Advanced Routing 會把 src/fetch.ts 當成請求管線入口。本文用 astro/fetch 示範保留內建路由、加入前後置邏輯、改名 fetchFile 與停用入口,並整理升級時的保留檔名風險。

Stage 04

網站要放在哪裡?

純靜態網站和需要伺服器的網站,適合的平台不一樣。先看清楚限制,上線後再逐項確認。

  1. 14. 比較 Cloudflare Pages 與 Workers

    Cloudflare Pages 的 Astro 檔案數超過怎麼辦?先分清 Pages 與 Workers

    Astro 部署到 Cloudflare Pages 失敗時,先計算 dist 檔案數與單檔大小,再比較 Free、付費 Pages 和 Workers Static Assets。本文也說明純靜態、SSR 與 bindings 的選擇邊界。

  2. 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 的取捨,並整理部署驗證。

  3. 16. 驗收其他平台的部署與備份

    Spacefast 部署 Astro 前:靜態、SSR、分享與資料匯出怎麼驗收?

    Spacefast 部署 Astro 時,先分清上傳 dist 和需要伺服器執行的 SSR。從同一份 Git commit 驗證深層網址與分享權限,再分開保存原始碼、資料庫匯出和網域設定,避免把站台版本回復當成完整備份,也能提早看出遷移時要重做哪些部分。

  4. 17. 發布給 AI 代理讀取的 poppy.json

    Astro 網站怎麼放 poppy.json?Poppy 1.0 探索路徑與網域驗收

    在 Astro 網站發布 Poppy 1.0 的 poppy.json,可以先用靜態網站入口支援未登入瀏覽。本文示範最小檔案與建置路徑,說明上線後怎麼檢查 HTTPS、重新導向的最終網址、實際回應的 JSON,以及主機名稱是否符合規格。

Stage 05

要升級了,怎麼避免出事?

先讀懂這次改了什麼,在本機跑過一輪再升。想換主題或 CMS,也先小範圍試試。

  1. 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、內容與互動元件遷移清單。

  2. 19. 排查 Vite 依賴預先打包錯誤

    Vite 出現 error while updating dependencies 怎麼修?先查快取與 linked package

    Vite 顯示 error while updating dependencies 時,先查 dev 預先打包、node_modules/.vite 與 linked package;Vite 8.3.1 也修正一種依賴掃描漏項。本文提供分層排查流程。

  3. 20. 升級 Starlight 文件站

    Starlight 0.42 升級要檢查什麼?Popover、JavaScript 與 sidebar

    Starlight 0.42 改用 Popover API 處理行動版選單,並改以編譯後 JavaScript 與型別定義發布。本文整理升級指令、sidebar、無 JavaScript、可及性與 Astro build 回歸檢查。

  4. 21. 評估是否改用 EmDash CMS

    EmDash 1.0 適合 Astro 部落格嗎?導入前檢查表

    EmDash 1.0 是建立在 Astro 上的 CMS,能否取代 Markdown 文章庫要看內容由誰維護、頁面如何更新與部署環境。這份檢查表整理兩種 collection 共存方式、SSR 限制、外掛沙箱與小規模試行步驟。