Headless CMS 架構模式

定義

把「內容管理介面」與「前台呈現技術」切開的架構模式。CMS 負責提供編輯體驗、權限管理、媒體上傳，透過 API 提供資料；前台技術（靜態網站、SPA、App）負責呈現，不受 CMS 的主題/模板綁定。此模式讓前台可以選擇速度、效能、品牌設計最佳的技術，後台可以選擇編輯團隊最熟悉的工具，兩者用 API 解耦。

關鍵數據點（附來源）

• astro-wp 以 WordPress Playground 為 CMS、Astro 為前台，證明「熟悉的編輯器 + 現代化靜態前台」可以共存（來源：astro-wp 文章）
• 合併時機發生在 build-time（而非 runtime），前台仍是純靜態，保留靜態站的速度與 SEO 優勢（來源：astro-wp 文章）
• 與 SaaS headless CMS（Sanity、Contentful）的主要差異是資料所有權——自架 CMS 內容完全在本機/自有主機（來源：astro-wp 文章）

前提與局限性

• API 契約穩定性： CMS 升級可能影響 API 格式，前台需同步調整
• build-time vs runtime： build-time 合併適合低頻更新內容，高頻更新（例如即時新聞）需要 runtime 或增量 build
• 內容模型 vs 前台元件： 兩者要對齊，否則編輯者在 CMS 看到的欄位跟前台呈現會對不上
• 權限粒度： CMS 的權限設定不會自動擴到前台——如果前台要做「編輯才看得到的草稿預覽」，需要額外實作

衝突標記

• 「Headless CMS 更自由」是宣傳用語。實務上 Headless 把原本 CMS 主題系統處理的事（導航、搜尋、篩選、分頁）全部推給前台開發者。對小團隊來說，傳統 WordPress 主題往往反而更快上線

關聯概念

• [[靜態網站架設]]
• [[內容自主權 vs 託管便利]]
• [[本機 Headless CMS 部署流程]]
• [[非工程師的 AI 工具採用]]