WordPress 轉 Astro：如何遷移 WordPress 網站，採用 headless 或完全搬離，同時保住排名

簡短回答

根據 W3Techs 2026 年 10 月 13 日的資料，所有網站中有 40.1% 使用 WordPress，因此大多數的網站遷移都是從 WordPress 開始。Astro 官方的遷移指南提出兩種做法：把 WordPress 保留為 headless CMS，由 Astro 建置前端；或是將內容完全搬離 WordPress。

不論選擇哪一種，保護流量的工作都一樣：保留每個帶來造訪的網址、沿用 SEO 外掛產生的標題與描述、複製上傳資料夾（uploads）、替換負責前端功能的外掛，並為每個有變動的網址設定永久轉址。照這個順序進行，新網站就能載入得更快、營運成本更低，排名也不必從零開始。

要用 headless WordPress，還是完全搬離？

Astro 對這兩種做法都有說明文件：將 WordPress 當作 headless CMS 使用，以及從 WordPress 遷移，後者建議使用 wordpress-export-to-markdown 工具來處理內容。

檢查八個線上 WordPress 網站時，我們看到了什麼

2026 年 10 月 13 日，我們檢查了八個以 WordPress 建置的網站，從 WordPress.org 自己的新聞部落格到大型媒體都有，看看一次遷移可以仰賴哪些東西：

• 八個網站中有七個透過 REST API 公開提供文章，位置在 /wp-json/wp/v2/posts。第八個回傳了 401：有些主機商與安全性外掛會鎖住 API，所以在以它為前提進行規劃之前，請先檢查你的網站。
• 八個網站中有三個還會隨每篇文章回傳 Yoast SEO 的資料。Yoast 會在標準的 REST 回應中加入 yoastheadjson 欄位，內含它為該頁面輸出的標題、描述、canonical 網址、Open Graph 標籤與 schema（Yoast 開發者文件）。這正是你需要的 SEO 中繼資料，可以直接沿用。
• 它們回傳的每個文章網址結尾都有斜線，七個網站中有五個的網址包含年份，例如 /2026/10/post-name/。Astro 必須完全重現這種結構，否則每篇文章都需要一個轉址。
• 八個網站中有六個仍在載入 jQuery，這提醒了我們，WordPress 佈景主題背負了多少前端程式碼，而以 Astro 重建時，這些都可以捨棄。

WordPress 轉 Astro 的步驟

1. 盤點每個網址。WordPress 自 5.5 版起會在 /wp-sitemap.xml 發布 sitemap，除非 SEO 外掛以自己的 sitemap 取代它（Make WordPress Core）。再加上以最長可用時間範圍從 Google Search Console 匯出的「網頁」報表，在「設定 > 永久連結」中記下永久連結結構，並匯出所有轉址外掛中的規則。
2. 決定要用 headless 還是完全搬離，可參考上方的表格。其餘步驟兩者皆適用；若採用 headless，「匯出」指的是在建置時從 API 讀取同樣的資料。
3. 匯出內容。「工具 > 匯出」會產生一個 WXR 檔案，也就是一份 XML 匯出檔，內含你的文章、頁面、自訂文章類型、留言、自訂欄位、分類、標籤、自訂分類法與使用者（WordPress 說明文件）。若要以腳本匯出，REST API 每頁最多回傳 100 篇文章，並附上每篇文章渲染後的 HTML。
4. 複製上傳的檔案。圖片並不在 XML 檔案裡：它們存放在 wp-content/uploads，旁邊還有 WordPress 為每張圖片產生的各種尺寸副本。保留原始圖片，讓 astro:assets 產生各種尺寸，並決定舊的圖片網址要維持不變，還是需要轉址。
5. 沿用 SEO 中繼資料。如果網站使用 Yoast SEO，就從 REST API 讀取每篇文章與每個頁面的 yoastheadjson：它提供的是最終的標題與描述，而不是外掛儲存的範本。否則，就從匯出檔中 SEO 外掛的自訂欄位取出這些資料。
6. 將範本重建為 Astro 元件。如果完全搬離，就把文章與頁面轉換為 content collections 或放進新的 CMS；如果採用 headless WordPress，就從 API 取得它們。檢查幾篇文章的 HTML，看看有沒有短代碼（shortcode）、嵌入內容與頁面建構工具（page builder）產生的標記，這些內容離開舊佈景主題後，往往需要清理才能正常顯示。
7. 替換負責前端功能的外掛。表單需要自己的端點（Cloudflare Worker、表單服務或你的 CRM），搜尋可以改用 Pagefind 這類靜態索引，留言則需要做個決定：保留、移到第三方服務，還是關閉。頁面事先建置完成後，快取外掛就沒有用武之地了。
8. 維持相同的網址結構。WordPress 的永久連結結尾通常帶有斜線，與 Astro 預設的目錄式輸出一致。以日期為基礎的永久連結要改用動態路由實現，例如 /[year]/[month]/[slug]/（Astro 路由）；分類與標籤彙整頁則需要有自己的頁面，或設定轉址。
9. 在伺服器端轉址，包括 WordPress 留下的網址。沒有使用 adapter 的靜態 Astro 建置，會把設定的轉址變成 meta refresh 頁面（Astro 設定參考），因此請在網站代管的地方設定一對一的 301 轉址。除了有變動的文章之外，也要涵蓋 WordPress 自動產生的網址：/feed/、?p= 短網址、附件頁面、作者彙整頁，以及你搬動過的任何 /wp-content/uploads/ 檔案。
10. 上線，然後持續觀察。切換 DNS，在新網站驗證完成前，讓舊的 WordPress 安裝只有你自己能存取，並在接下來幾週追蹤 Search Console 的索引報表。我們的網站遷移 SEO 檢查清單涵蓋了上線當天及之後 90 天的工作。

遷移後有哪些改變

保住 SEO

Google 的變更網址的網站搬遷指南在這裡同樣適用：將每個舊網址對應到最相近的新網址、使用伺服器端永久轉址，並至少保留一年。與大多數平台相比，WordPress 更容易做到網址完全不變，因為它結尾帶斜線的永久連結與 Astro 的預設值一致；真正的工作在於重現日期路徑、彙整頁，以及每一個由外掛產生的網址。

接著檢查舊佈景主題與外掛在每個頁面上加入了什麼：canonical 標籤、Open Graph 圖片、結構化資料、多語系外掛產生的 hreflang 標籤，以及 robots 規則。新網站上少了任何一項，都是 Google 在切換當天失去的一個訊號。

Dardo 如何執行 WordPress 遷移

我們將 WordPress 遷移納入網站遷移服務中執行：盤點網址與內容、決定採用 headless 還是完全搬離，先重建一個具代表性的頁面並在約定的寬度下審查，接著再處理其餘的範本、表單與轉址。建置本身屬於以 Astro 進行的網站開發。如果你還在考慮是否要離開 WordPress，我們比較 WordPress 與客製化網站的文章說明了兩者各自在什麼情況下值得投資；我們的 Framer 與 Webflow 遷移指南，則涵蓋了另外兩個常見的起點。

如果你正在評估是否要遷移，把網站和你想改變的地方告訴我們。在報價之前，我們會先告訴你適合採用 headless 還是完全搬離。