---
title: "WordPress 轉 Astro：保住 SEO 的遷移方法"
description: "WordPress 轉 Astro：選擇 headless 或完全搬離、匯出文章與 Yoast 中繼資料、維持永久連結一致，並為 WordPress 網址設定轉址。"
url: "https://dardo.studio/zh-Hant/blog/wordpress-to-astro/"
language: "zh-Hant"
translations: {"en":"https://dardo.studio/en/blog/wordpress-to-astro/","es":"https://dardo.studio/es/blog/migrar-de-wordpress-a-astro/","fr":"https://dardo.studio/fr/blog/migrer-wordpress-vers-astro/","de":"https://dardo.studio/de/blog/wordpress-zu-astro-migrieren/","it":"https://dardo.studio/it/blog/migrare-da-wordpress-ad-astro/","pt":"https://dardo.studio/pt/blog/migrar-de-wordpress-para-astro/","nl":"https://dardo.studio/nl/blog/wordpress-naar-astro/","sv":"https://dardo.studio/sv/blogg/migrera-wordpress-till-astro/","pl":"https://dardo.studio/pl/blog/migracja-z-wordpressa-do-astro/","uk":"https://dardo.studio/uk/blog/wordpress-to-astro/","ru":"https://dardo.studio/ru/blog/wordpress-to-astro/","ar":"https://dardo.studio/ar/blog/wordpress-to-astro/","hi":"https://dardo.studio/hi/blog/wordpress-to-astro/","th":"https://dardo.studio/th/blog/wordpress-to-astro/","ja":"https://dardo.studio/ja/blog/wordpress-to-astro/","ko":"https://dardo.studio/ko/blog/wordpress-to-astro/","zh-Hans":"https://dardo.studio/zh-Hans/blog/wordpress-to-astro/"}
updated: "2026-10-13T02:38:56.731Z"
---

[部落格](https://dardo.studio/zh-Hant/blog/)

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

WordPress 轉 Astro 的兩種做法：該匯出什麼、如何保住 Yoast 標題、永久連結與上傳的圖片，以及多數遷移都會遺漏的 WordPress 網址。

作者： [Nicolás Cerón](https://dardo.studio/zh-Hant/studio/) ·2026年10月12日

![夜晚，一座搭著鷹架、窗戶亮著燈的大型古老宅邸；鵝卵石小徑上，一台手推車載著一只深紅色的旅行箱，小徑一路通往山丘上一座亮著燈的小天文台。](https://dardo.studio/_astro/01M4SH202BB16HWS7MBCWHNP1S_Z2cx2K1.webp)

## 重點

- 你可以把 WordPress 保留為 Astro 背後的 headless CMS，也可以將內容完全搬離；無論哪一種，保住網址與中繼資料的 SEO 工作都一樣。
- 「工具 > 匯出」會產生一個 WXR 檔案，內含文章、頁面、留言、自訂欄位與分類法；圖片仍留在 wp-content/uploads 中，必須另外複製。
- 使用 Yoast SEO 時，REST API 會在 yoast\_head\_json 中回傳每個頁面最終的標題、描述、canonical 與 Open Graph 標籤，可以直接沿用。
- WordPress 的永久連結結尾帶有斜線，與 Astro 的預設輸出一致；請用動態路由重現以日期為基礎的路徑，而不是為它們設定轉址。
- WordPress 自動產生的網址也要轉址：feed、?p= 短網址、附件頁面、作者彙整頁，以及你搬動過的任何上傳檔案。

## 簡短回答

根據 [W3Techs](https://w3techs.com/technologies/details/cm-wordpress) 2026 年 10 月 13 日的資料，所有網站中有 40.1% 使用 WordPress，因此大多數的網站遷移都是從 WordPress 開始。Astro 官方的[遷移指南](https://docs.astro.build/en/guides/migrate-to-astro/from-wordpress/)提出兩種做法：把 WordPress 保留為 headless CMS，由 Astro 建置前端；或是將內容完全搬離 WordPress。

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

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

|                  | 將 WordPress 保留為 headless CMS   | 將內容搬離 WordPress                  |
| ---------------- | ------------------------------ | -------------------------------- |
| 編輯               | 同樣的 WordPress 控制台              | 新的 CMS，或儲存庫中的 Markdown 檔案        |
| Astro 從哪裡讀取內容    | WordPress REST API 或 WPGraphQL | Content collections 或新 CMS 的 API |
| 是否還要維護 WordPress | 要：主機代管、更新與安全性修補，不過它不必再對外公開     | 不需要                              |
| 外掛               | 編輯用的外掛照常運作；凡是在佈景主題中執行的功能都要重建   | 仍需要的功能全部重建或替換                    |
| 最適合              | 大型編輯團隊習慣在 WordPress 中作業        | 網站很少更動，或團隊本來就要換用新的 CMS           |

Astro 對這兩種做法都有說明文件：[將 WordPress 當作 headless CMS 使用](https://docs.astro.build/en/guides/cms/wordpress/)，以及[從 WordPress 遷移](https://docs.astro.build/en/guides/migrate-to-astro/from-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 回應中加入 yoast_head_json 欄位，內含它為該頁面輸出的標題、描述、canonical 網址、Open Graph 標籤與 schema（[Yoast 開發者文件](https://developer.yoast.com/customization/apis/rest-api/)）。這正是你需要的 SEO 中繼資料，可以直接沿用。
- **它們回傳的每個文章網址結尾都有斜線，七個網站中有五個的網址包含年份**，例如 /2026/10/post-name/。Astro 必須完全重現這種結構，否則每篇文章都需要一個轉址。
- **八個網站中有六個仍在載入 jQuery**，這提醒了我們，WordPress 佈景主題背負了多少前端程式碼，而以 Astro 重建時，這些都可以捨棄。

## WordPress 轉 Astro 的步驟

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

## 遷移後有哪些改變

| 項目   | 在 WordPress 上       | 在 Astro 上                                     |
| ---- | ------------------- | --------------------------------------------- |
| 編輯   | WordPress 控制台與區塊編輯器 | 作為 headless CMS 的 WordPress、其他 CMS 或 Markdown |
| 主機代管 | PHP 伺服器與資料庫         | 任何靜態主機或邊緣平台，例如 Cloudflare                     |
| 更新   | 必須持續跟上核心、佈景主題與外掛的更新 | 儲存庫中的相依套件更新，公開伺服器上無須更新                        |
| 表單   | 表單外掛                | 你自己的端點與資料儲存                                   |
| 搜尋   | WordPress 內建搜尋或搜尋外掛 | 靜態索引或搜尋服務                                     |
| 效能   | 快取與最佳化外掛            | 事先建置完成的頁面，只在你加入的地方使用 JavaScript               |

## 保住 SEO

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

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

## Dardo 如何執行 WordPress 遷移

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

如果你正在評估是否要遷移，[把網站和你想改變的地方告訴我們](https://dardo.studio/zh-Hant/contact/?service=website-migration)。在報價之前，我們會先告訴你適合採用 headless 還是完全搬離。

## 常見問題

**WordPress 可以搭配 Astro 使用嗎？**

可以。WordPress 可以繼續作為 headless CMS：編輯人員照樣使用 WordPress 控制台，Astro 則透過 REST API 或 WPGraphQL 建置公開網站。Astro 在其 WordPress CMS 指南中說明了這種架構。

**如何將 WordPress 內容匯出到 Astro？**

使用「工具 > 匯出」產生 WXR 檔案，再用 wordpress-export-to-markdown 等工具轉換；也可以透過 REST API 讀取文章，每次請求最多 100 篇。wp-content/uploads 必須另外複製，因為圖片並不在匯出檔中。

**從 WordPress 轉到 Astro，會讓 Google 排名下降嗎？**

只要每個帶來流量的網址都持續有回應，就不會。維持永久連結結構（包括結尾的斜線），沿用標題、描述與結構化資料，為有變動的網址加上 301 轉址，並在上線後幾週持續關注 Search Console。

**我的 WordPress 外掛會怎麼樣？**

在 headless 架構中，協助編輯的外掛可以繼續運作；但凡是在佈景主題中執行的功能，例如表單、輪播、搜尋、留言或頁面建構工具，都必須重建或替換，因為公開頁面改由 Astro 自行渲染。

**Astro 比 WordPress 快嗎？**

Astro 網站是事先建置完成的，只在你加入的地方傳送 JavaScript，因此不需要 PHP 伺服器或快取外掛來回應每次造訪。實際快多少，取決於原本的 WordPress 佈景主題載入了哪些東西，所以遷移前後都要測量。

## 資料來源與延伸閱讀

本頁內容的資料來源，並附上原始發布者提供的更多詳情。

- [W3Techs：WordPress 使用統計（英文）](https://w3techs.com/technologies/details/cm-wordpress) · w3techs.com
- [Astro 文件：從 WordPress 遷移（英文）](https://docs.astro.build/en/guides/migrate-to-astro/from-wordpress/) · docs.astro.build
- [Astro 文件：Headless WordPress 與 Astro（英文）](https://docs.astro.build/en/guides/cms/wordpress/) · docs.astro.build
- [WordPress 說明文件：「工具 > 匯出」畫面（英文）](https://wordpress.org/documentation/article/tools-export-screen/) · wordpress.org
- [WordPress REST API 手冊：文章（英文）](https://developer.wordpress.org/rest-api/reference/posts/) · developer.wordpress.org
- [Make WordPress Core：WordPress 5.5 新增的 XML sitemap 功能（英文）](https://make.wordpress.org/core/2020/07/22/new-xml-sitemaps-functionality-in-wordpress-5-5/) · make.wordpress.org
- [Yoast 開發者文件：REST API（英文）](https://developer.yoast.com/customization/apis/rest-api/) · developer.yoast.com
- [GitHub 上的 wordpress-export-to-markdown（英文）](https://github.com/lonekorean/wordpress-export-to-markdown) · github.com
- [Astro 文件：Content collections（英文）](https://docs.astro.build/en/guides/content-collections/) · docs.astro.build
- [Astro 文件：圖片（英文）](https://docs.astro.build/en/guides/images/) · docs.astro.build
- [Astro 文件：路由（英文）](https://docs.astro.build/en/guides/routing/) · docs.astro.build
- [Astro 文件：設定參考（英文）](https://docs.astro.build/en/reference/configuration-reference/) · docs.astro.build
- [Pagefind：靜態搜尋（英文）](https://pagefind.app/) · pagefind.app
- [Google 搜尋中心：變更網址的網站搬遷](https://developers.google.com/search/docs/crawling-indexing/site-move-with-url-changes) · developers.google.com

[Nicolás Cerón](https://dardo.studio/zh-Hant/studio/)

Nicolás Cerón 是 Dardo 的創辦人。Dardo 是一間位於哥倫比亞波哥大的品牌、網頁設計與開發工作室。

## 相關文章

- [**WordPress vs 客製化網站：該怎麼選？各自在什麼情況下值得投資**WordPress vs 客製化網站：什麼時候該選 WordPress、什麼時候客製化網站更划算，以及 headless WordPress 這條中間路線，從成本、速度、更新與所有權全面比較。](https://dardo.studio/zh-Hant/blog/wordpress-vs-custom-website/)
- [**Webflow 轉 Astro：如何遷移 Webflow 網站，同時保住內容、設計與排名**Webflow 轉 Astro 之前要知道：程式碼匯出不含 CMS、表單、搜尋與多語系頁面。本文說明該從 Webflow 匯出什麼、在 Astro 重建什麼，以及如何保住排名。](https://dardo.studio/zh-Hant/blog/webflow-to-astro/)
- [**網站改版與搬遷 SEO 檢查清單：更換平台或網域，也不掉排名**排名下滑，通常不是因為換了新平台，而是原本帶來流量的網址不再有回應。這份檢查清單從網址盤點一路帶你走到第 90 天。](https://dardo.studio/zh-Hant/blog/website-migration-seo-checklist/)
- [**哥倫比亞網站製作費用：2026 年做網站要多少錢？實際價格與影響報價的因素**哥倫比亞網站製作費用整理：波哥大業者公開且註明日期的價格、網域與主機每年的固定費用，以及真正會影響網站報價的因素。](https://dardo.studio/zh-Hant/blog/website-cost-colombia/)

## 繼續探索。

- [服務 · **網站遷移，不流失 SEO 成果**](https://dardo.studio/zh-Hant/services/website-migration/)

- [您的專案 · **開始聊聊**](https://dardo.studio/zh-Hant/contact/)
