# Wix Headless：將網站遷移至自訂前端

Source: https://support.wix.com/zh-hant/article/wix-headless-moving-your-site-to-a-custom-frontend-zh-hant (updated 2026-11-03)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

> 此功能目前僅適用於使用英文的帳戶。

取代使用 Wix 編輯器建立的前端，改用 Claude Code、Cursor 或 Codex 等 AI 程式設計工具建立自訂前端，為商家打造新網站。

所有已連結的商務工具（例如 Wix Stores、Wix Bookings）和資料（例如 SEO、分析）都會持續運作，不會中斷。如果已有自訂前端，可使用 AI 程式設計工具將其設為 Wix Headless 前端。

[Video](https://www.youtube.com/embed/ydHT8tO0j70)

---

## 適用對象

如果已有已上線的 Wix 網站並連結自訂網域，且只想使用 AI 程式設計工具建立的內容取代前端（訪客看到的部分），即可遷移至 Headless 網站。

若符合以下情況，Wix Headless 可能很適合：

* 已有已上線的 Wix 網站並連結商務工具（例如 Wix Stores、Wix Bookings、連絡人和會員），而且想建立新前端，無須重新建置這些功能。
* 網站負責人（或參與網站開發的開發人員或代理商）希望直接編寫前端程式碼，享有完整的設計自由，而不是使用 Wix 編輯器建立前端。
* 想建立新前端，同時保留所有網站資料，包括分析和 SEO。
* 想嘗試使用 AI 程式設計工具建立前端，又不想影響已上線的網站。

> **注意：** 如果偏好使用 Wix 編輯器或 Studio 編輯器進行視覺化建置，或沒有開發人員或 AI 程式設計工作流程，請勿遷移至 Wix Headless。Wix Headless 需要使用自行準備的前端程式碼。

### 開始前須知

* **網站必須連結網域。**只有已連結網域的網站才能遷移至 Wix Headless。
* **一次只能有一個已上線的前端。**切換至新前端後，訪客看到的現有前端將由新前端取代，兩者無法同時上線。
* **SEO 會移至新前端。**完成遷移後，SEO 和分析會自動套用至新前端。請留意，大幅變更頁面、內容或網站結構，可能會自然影響 SEO。
* **檢查支援的應用程式。**切換後，大部分已連結的應用程式會繼續運作，但新前端目前不支援部分應用程式。仍可前往網站管理介面進行管理。[查看支援與不支援的完整應用程式清單。](https://support.wix.com/zh-hant/article/wix-headless-supported-and-unsupported-apps)

### 網站遷移需求

開始遷移前，網站必須符合下列所有需求：

* **網站擁有者身分：**只有網站擁有者能開始遷移。如果是共同作業者，請要求網站擁有者開始遷移。
* **網站使用自訂網域：**開始前，請先[將網域連結](https://support.wix.com/zh-hant/article/about-domains)至網站。
* **商店使用新版 Wix Stores 目錄：**如果網站使用 Wix Stores，必須使用[新版產品目錄](https://support.wix.com/zh-hant/article/introducing-the-new-wix-stores-product-catalog)。
* **網站未使用應用程式專案的自訂組件：**如果目前網站包含在應用程式專案中建立的自訂組件，暫時無法遷移。若要改用 Headless 架構，請改為[建立新的 Headless 網站](https://support.wix.com/zh-hant/article/wix-headless-creating-a-site-with-ai-tools)。

---

## 遷移流程

以下逐步說明遷移流程。若要開始遷移，請按照下一節的步驟操作。

1. **開始遷移。**從網站管理介面的 Headless 設定開始遷移。Headless 會提供包含網站詳細資訊的專屬指令。
2. **使用 AI 程式設計工具建立新前端。**將指令貼到 AI 程式設計工具，接著建立訪客會看到的所有內容，包括頁面、區段和元件。可以從頭開始，也可複製目前的設計作為基礎。您可在遷移過程中逐步建立前端，也可在開始遷移前完成。
3. **預覽並測試新前端。**新前端會與目前網站並列顯示為獨立檢視畫面。訪客只會看到已上線的網站，因此可持續調整，直到所有內容的外觀和運作方式都符合需求。產品、服務、預訂和其他資料都會保留，隨時可連結至新前端。
4. **切換至新前端。**準備就緒後，將新前端設為已上線網站。自訂網域和資料追蹤功能會一併移轉，系統也會取消發布舊網站。新網站只會顯示透過 AI 程式設計工具新增的頁面，且可隨時切換回舊網站。

---

## 將網站遷移至自訂前端

遷移至 Wix Headless，使用 AI 程式設計工具建立新前端，並在準備就緒後發布。

> **開始之前：** 請確認網站符合上述所有[要求](https://support.wix.com/zh-hant/article/wix-headless-moving-your-site-to-a-custom-frontend#requirements-for-migrating-your-site)。

### 將網站遷移至自訂前端：

1. [前往 Headless 設定](https://manage.wix.com/my-account/site-selector/?siteType=HtmlWeb&actionUrl=https://www.wix.com/dashboard/{{metaSiteId}}/oauth-apps-settings?referralInfo=settings-lobby?&title=Select%20a%20site&buttonText=Go+to+Headless+Settings)（位於網站管理介面）。
2. 向下捲動，然後點擊**「Headless 遷移」**下方的**「開始遷移」**。
3. 點擊**「立即開始」**，為商家設定新前端。
4. 查看哪些應用程式會遷移、哪些不受支援，然後點擊**「繼續」**。
5. 點擊**「複製指令」**，並將指令貼到 AI 程式設計代理程式。系統會透過 Headless 技能，向代理程式提供該網站的專屬資訊。

![Headless 遷移流程中的複製指令步驟。](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/0e97b94c-47b2-498e-a44b-b1be88db7e56/2026/10/07/0de5e88d-3cf9-4200-9aa4-9612fdc88b1d/Headless_migration.jpg)

1. 使用 AI 程式設計代理程式建立並持續調整前端。
2. （選填）在 Headless 設定中點擊**「查看」**，即可預覽 Headless 網站。
3. 點擊**「完成遷移」**。
4. 將指令複製並貼到 AI 程式設計代理程式，即可取代並發布新前端。

> **後續步驟：** 切換後，請查看需要重新建立的內容，例如表單、重新導向、SEO 和分析。請參閱[遷移後檢查清單](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/get-started/post-migration-checklist-wix-studio-and-editor-sites-to-headless)，並將清單分享給 AI 程式設計工具。

---

## 常見問題

點擊下方問題，深入了解 Wix Headless 遷移。

**切換前可以預覽新的前端嗎？**

可以。切換前，可視需要多次預覽新前端。目前的網站會持續運作，只有在決定切換後才會變更。

**開始遷移前可以先建置前端嗎？**

可自行決定。您可先使用 AI 程式設計工具建置自訂前端，等準備好後再開始遷移；也可以先開始遷移，並在過程中逐步建置。

**切換至新前端後可以復原嗎？**

不可以。隨時都能前往網站管理介面的「Headless 設定」頁面，點擊**「切換回原網站」**返回舊網站。

**切換後，舊網站會發生什麼變化？**

> 發佈新前端後，該前端就會成為主要網站。這表示：
> 
> * 自訂網域會切換至新網站，且系統會取消發佈舊網站。
> * SEO 和分析等工具會改為追蹤新前端
> * 僅存在於舊網站的頁面會隱藏
> * [任何不受支援的應用程式](https://support.wix.com/zh-hant/article/wix-headless-supported-and-unsupported-apps)都無法在新前端使用，但仍可透過管理介面進行管理。

**SEO 和分析會發生什麼變化？**

切換前，兩者都會維持在目前的網站上。切換後，系統會自動將兩者移轉至新前端。請留意，大幅變更頁面、內容或網站結構，自然可能會影響 SEO。

**Wix 方案會變更嗎？**

不會。在建置、預覽及切換前端期間，網站會保留目前的方案。

**為什麼切換後部分舊頁面連結會失效？**

切換後，只有在新前端中建置的頁面會透過網域上線。僅存在於舊網站的頁面會隱藏，因此指向這些頁面的連結（例如書籤、搜尋結果或行銷活動）會開啟 404 錯誤頁面。

若要讓這些連結繼續運作，請將舊網址[設定 301 重新導向](https://support.wix.com/zh-hant/article/setting-up-a-301-redirect-for-a-page-on-your-site)至新前端上的對應頁面。您可繼續使用目前的網址重新導向管理員。如果網站使用 Wix Multilingual，也可以[設定特定語言的重新導向](https://support.wix.com/zh-hant/article/setting-up-a-301-redirect-for-a-multilingual-site)。

**可以繼續使用 Wix Forms 嗎？**

可以。Wix Forms 會繼續透過管理介面執行，包括提交內容、連絡人、自動化功能及通知電子郵件。不過，在編輯器中新增的表單不會顯示於新前端。 

請要求 AI 程式設計工具或開發人員在新前端重建這些表單，並使用 [Wix Forms API](https://dev.wix.com/docs/api-reference/crm/forms/form-submissions/introduction) 連結表單。系統不會刪除過去的提交內容。

**Wix Multilingual 可以搭配新前端使用嗎？**

可以。AI 程式設計工具或開發人員可以為新前端[新增多語言支援](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/feature-guides/add-multilingual-support)。接著，即可在網站管理介面的翻譯管理員中，透過「**Headless**」區段管理翻譯。 

系統不會自動複製舊網站的翻譯，因此需要翻譯新前端中顯示的內容。

**Wix Chat 的變化**

Wix 聊天小工具不會顯示在新前端，Wix 智慧聊天目前也[尚未支援](https://support.wix.com/zh-hant/article/wix-headless-supported-and-unsupported-apps)。這兩項功能仍會保留在網站上，且仍可從管理介面管理。

若要讓訪客透過聊天聯絡，可請開發人員使用 [AI Site-Chat API](https://dev.wix.com/docs/api-reference/business-management/ai-site-chat/introduction)，在新前端建置自訂聊天功能。仍可透過「收件匣」和 Wix 應用程式回覆訊息。

**重要事項：**切換前，請先在目前的網站安裝並設定 Wix 智慧聊天。新前端上線後，便無法再新增 Wix 智慧聊天。

**Velo 程式碼的變化**

切換後，頁面上的 Velo 程式碼將停止執行，因為訪客不再載入舊網站的頁面。系統不會刪除後端程式碼（例如 HTTP 函式、排程工作、資料鉤）：

* 新前端仍可呼叫現有的 [HTTP 函式](https://dev.wix.com/docs/go-headless/coding/java-script-sdk/calling-site-http-functions)。
* 頁面程式碼和網路模組（.jsw 檔案）需要在新前端中重新建置。

若切換回舊網站，Velo 程式碼仍會保留。
