SPA SEO:如何讓單頁應用程式被 Google 建立索引
簡短回答 Google 可以為單頁應用程式建立索引,但它要先執行頁面的 JavaScript 才能讀取內容,這一步可能延遲或失敗;而很多其他檢索器,包括 AI 檢索器,根本不執行 JavaScript。讓每個頁面的文字以 HTML 形式送出(伺服器端轉譯或預先轉譯),給每個畫面一個獨立網址,並為每個頁面設定不同的標題。
想把這些用在您的生意上?預約一次 30 分鐘的免費通話,一起聊聊。
預約通話Google 能為單頁應用程式建立索引嗎?
能,但會有延遲,也有風險。單頁應用程式(SPA)傳給瀏覽器的是一個幾乎空白的頁面加上 JavaScript,訪客看到的內容由 JavaScript 產生。Google 必須先執行這些程式碼,才能讀到您的文字。Google 的 JavaScript SEO 指南說,等待這一步的頁面「may stay on this queue for a few seconds, but it can take longer than that」(可能在佇列中停留幾秒,但也可能更久)。同一份指南在說明的結尾給出了一錘定音的建議:
"Keep in mind that server-side or pre-rendering is still a great idea because it makes your website faster for users and crawlers, and not all bots can run JavaScript." (Google Search Central: Understand the JavaScript SEO basics) 譯文:「請記住,伺服器端轉譯或預先轉譯仍然是很好的做法,因為它能讓您的網站對使用者和檢索器都更快,而且並非所有機器人都能執行 JavaScript。」
| 誰在讀取您的網站 | 執行 JavaScript 嗎? | 在一般 SPA 上看到什麼 |
|---|---|---|
| Google 搜尋 | 執行,但稍後在第二步進行 | 您的內容,前提是程式碼執行無誤 |
| 其他搜尋引擎 | 不一定。Google 說它們「may choose to ignore JavaScript」(可能選擇忽略 JavaScript) | 可能是空白頁面 |
| AI 檢索器(ChatGPT、Claude) | 不執行,根據 2024 年 12 月對 Vercel 網路的一項研究 | 空白頁面 |
這項研究來自 Vercel:透過監測其代管網路上的流量,它發現「none of the major AI crawlers currently render JavaScript」(目前主要的 AI 檢索器都不轉譯 JavaScript)。如果您希望 ChatGPT 或 Claude 引用您的服務,文字必須在 HTML 裡。
怎樣查看 Google 在我的 SPA 上看到了什麼?
依序做三項檢查:
- 查看原始 HTML。 打開一個頁面,按 Ctrl+U(Mac 上按 Cmd+Option+U),搜尋頁面上的一句話。如果找不到,不執行 JavaScript 的檢索器什麼也看不到。
- 查看 Google 轉譯後的版本。 Google 建議用複合式搜尋結果測試或 Search Console 中的網址審查工具來「check if the rendered HTML has all content you expect」(檢查轉譯後的 HTML 是否包含您預期的全部內容)。兩者都會顯示 Google 執行程式碼後的頁面,以及任何 JavaScript 錯誤。
- 數一數已建立索引的頁面。 Search Console 的「網頁」報表會顯示哪些網址已建立索引。一個有 20 個頁面卻只有 1 個網址被建立索引的網站,通常是網址出了問題(見下文)。請參閱小型企業如何使用 Google Search Console。
如果第 1 步不通過、第 2 步通過,表示 Google 能讀到您,其他檢索器讀不到。如果兩步都不通過,先解決轉譯問題。
SSR、預先轉譯還是動態轉譯:該選哪種?
把文字放進伺服器送出的 HTML 裡。有三種做法,Google 推薦其中兩種。
| 方法 | 意思 | 最適合 | 缺點 |
|---|---|---|---|
| 伺服器端轉譯(SSR) | 每次有人要求時,由伺服器產生該頁的 HTML | 經常變動的頁面:價格、列表、庫存 | 需要持續運作的伺服器,成本較高 |
| 預先轉譯,或靜態網站產生(SSG) | 每個頁面的 HTML 在發布時一次產生 | 服務頁、關於我們、聯絡頁、部落格 | 內容一改就要重新建置 |
| 動態轉譯 | 機器人拿到預先產生的副本,真人使用應用程式 | 暫時無法重建的舊應用程式的權宜之計 | Google 已不再推薦 |
Vue 的文件給了業主一個實用的捷徑:如果您考慮 SSR 只是為了改善少數行銷頁面(例如 / 和 /about)的 SEO,那您可能需要的是 SSG。對於動態轉譯,Google 說得很直接:
"Dynamic rendering was a workaround and not a long-term solution for problems with JavaScript-generated content in search engines." (Google Search Central: Dynamic rendering as a workaround) 譯文:「動態轉譯是一種權宜之計,並不是解決搜尋引擎中 JavaScript 產生內容問題的長期方案。」
Google 也說,只要兩個版本內容相似,它一般不會把動態轉譯視為偽裝(cloaking,即給機器人和真人看不同的內容)。
React、Vue 和 Angular:解決辦法在哪裡
現在每個框架都內建伺服器端轉譯的方式,您的開發人員很少需要自己架設。
| 用什麼建置 | 轉譯選項 | 頁面標題和說明 |
|---|---|---|
| React | 使用 Next.js 或 React Router 等框架。React 文件說:「we recommend starting with a framework」(我們建議從框架開始) | Next.js:`metadata` 或 `generateMetadata`。React Router:每個路由匯出一個 `meta` |
| Vue | Nuxt,預設使用伺服器端轉譯,「to optimize search engine indexing」(以最佳化搜尋引擎索引) | Nuxt:`useSeoMeta` 或 `useHead` |
| Angular | `@angular/ssr`,用 `ng add @angular/ssr` 加入。不加入的話,Angular 應用程式在用戶端轉譯 | Angular 的 `Title` 和 `Meta` 服務 |
| AI 應用程式產生工具(Lovable) | 2026 年 5 月 13 日起(企業版為 6 月 22 日)的新應用程式使用伺服器端轉譯;更早的應用程式會為經過驗證的檢索器提供預先轉譯版本 | 在產生工具裡設定 |
舊建議中的兩個名字已經過時。Create React App 於 2025 年 2 月 14 日停止建議用於新應用程式(React Blog)。Angular Universal 在 Angular 17 中併入 `@angular/ssr`,其程式碼庫已於 2024 年 11 月 22 日封存。如果報價或方案裡出現其中任何一個,請問清楚原因。
每個畫面都需要獨立網址嗎?
需要。網址是 Google 唯一能建立索引的東西,所以沒有獨立網址的服務頁無法單獨取得排名。舊的 SPA 常用 `example.com/#/services` 這樣的網址。Google 的疑難排解指南說,針對這類網址的舊方案已經不再支援:
"The AJAX-crawling scheme has been deprecated since 2015, so you can't rely on URL fragments to work with Googlebot." (Google Search Central: Fix search-related JavaScript problems) 譯文:「AJAX 檢索機制自 2015 年起已停止支援,因此您不能指望網址片段對 Googlebot 有效。」
解決辦法是用瀏覽器的 History API 做路由,讓每個畫面都有 `example.com/services` 這樣的一般網址。三個框架的現代路由預設都是這樣做的。連結必須是真正的連結:Google 說它只能發現帶有 `href` 網址的 HTML 連結元素(`a` 標記)。用點擊事件切換畫面的按鈕,會讓該頁面對 Google 不可見。接著把所有公開網址列進 Sitemap,並在 Search Console 中提交。
在 SPA 中如何為每頁設定標題和中繼標記?
給每個網址設定獨立的標題、說明和標準標記(canonical,指明某個頁面主要版本的標記)。Google 說標題和說明可以由 JavaScript 設定。有兩個標記需要多加小心:
- 標準標記: 寫在 HTML 裡。Google 說如果由 JavaScript 設定,它必須與原始 HTML 中的值一致,而且只能有一個。
- Noindex: 不要在您希望被找到的頁面的初始 HTML 裡放 noindex,再打算之後用 JavaScript 移除。Google 的指南警告:「When Google encounters the noindex tag, it may skip rendering and JavaScript execution」(當 Google 遇到 noindex 標記時,可能會略過轉譯和 JavaScript 執行)。
要讓連結在 Facebook、LinkedIn 或簡訊中顯示預覽,請為每個網址加入 Open Graph 標記(`og:title`、`og:description`、`og:image`、`og:url`)。Meta 的指南說:「To see how your markup appears to the Facebook Crawler enter a URL into Sharing Debugger」(要查看 Facebook 檢索器如何看待您的標記,請在分享偵錯工具中輸入網址)。如果每個分享出去的連結都顯示首頁標題,表示您的標記只由 JavaScript 設定,或者只設定了一次。
結構化資料(schema 標記)也可以來自 JavaScript:Google 說您可以產生 JSON-LD 並插入頁面,然後進行測試。複合式搜尋結果測試會顯示 Google 是否看到了它。
頁面不存在和軟性 404 怎麼辦?
SPA 常常對每個網址,哪怕是打錯的網址,都回傳「200 OK」狀態碼,然後再用 JavaScript 顯示「找不到頁面」。Google 把這稱為軟性 404(自稱正常的錯誤頁面)。Google 的 JavaScript 指南為用戶端應用程式提供了兩種解決辦法:
- 用 JavaScript 重新導向到伺服器會回傳真正 404 狀態碼的網址,例如 `/not-found`。
- 用 JavaScript 為錯誤畫面加入 `noindex` robots 中繼標記。
速度、延遲載入和檢索預算重要嗎?
速度對訪客很重要;檢索預算對小型企業幾乎從不重要。Google 的檢索預算指南針對的是擁有「1 million+ unique pages」(100 萬個以上不重複頁面)或每天變動的「10,000+ unique pages」(1 萬個以上不重複頁面)的網站。一個 30 頁的服務網站遠遠達不到。
延遲載入(捲動到時才載入圖片)沒問題,只要遵循 Google 的指南:在內容「whenever it is visible in the viewport」(出現在可視區域時)載入,使用瀏覽器內建的延遲載入或 IntersectionObserver API。第一個畫面顯示的內容不要延遲載入。Google 沒有公布它會等待 JavaScript 多少秒;真正的風險是程式碼出錯,或要等使用者點擊才載入內容。關於速度和排名,請參閱 Core Web Vitals。
GA4 能追蹤 SPA 中的網頁瀏覽嗎?
通常可以,不用寫程式碼。GA4 的加強型評估會在頁面載入時,「or the browser history state is changed by the active site」(或目前網站變更瀏覽器歷史記錄狀態時)傳送網頁瀏覽事件,說明頁面還提到這個選項會「listens for pushState, popState, and replaceState」(監聽 pushState、popState 和 replaceState)。前提是每個畫面都會改變網址,這又是一個要把路由修好的理由。要追蹤電話和表單,請參閱 GA4 重要事件。
範例
以下為示意案例,數字為虛構。
一家清潔公司用 Vue 做的預約網站(美元)
Search Console 顯示 12 個頁面中只有 1 個已建立索引,而且每個網址都以 `/#/` 開頭。開發人員把路由切換為 History 模式,加入 Sitemap,並為每頁設定標題。把 12 個公開頁面移到 Nuxt 預先轉譯後,AI 檢索器也能在 HTML 中讀到文字。報價:$1,500 到 $3,000。
多倫多一家物理治療診所的 React 應用程式(加幣)
網站用 Create React App 建置。查看原始碼只看到一個沒有文字的空頁面框架。用 Next.js 重建公開頁面的報價是 C$4,000;登入後的病患入口網站仍維持一般 SPA,因為它不需要被搜尋到。
2026 年初業主自己用 Lovable 架設的網站
它早於 2026 年 5 月的切換,所以檢索器拿到的是預先轉譯的副本。網址審查顯示了完整文字;業主確認每項服務都有自己的網址和標題,然後提交 Sitemap。
常見問題
SPA 對 SEO 不好嗎?
本身不是。只在用戶端轉譯的 SPA 對需要被找到的頁面有風險;同一個應用程式加上伺服器端轉譯或預先轉譯後,建立索引的情況和一般網站一樣。
我需要重建整個應用程式嗎?
通常不需要。把公開頁面(首頁、服務、價格、聯絡)放到伺服器端或建置時轉譯即可。登入後的區域可以繼續在用戶端轉譯,它們本來就不應該出現在搜尋結果裡。
prerender.io 或類似服務安全嗎?
那就是動態轉譯。只要機器人和真人看到的內容相似,Google 可以接受,但它稱之為權宜之計,而不是長期方案。
Bing 會轉譯 JavaScript 嗎?
2018 年,Bing 寫道它的檢索器「is generally able to render JavaScript」(一般能夠轉譯 JavaScript)(Bing Webmaster Blog),但 Google 自己的指南提醒,其他搜尋引擎可能會忽略 JavaScript。直接提供 HTML,對所有檢索器都不再是問題。
您的情況不同?
- 您的網站在 Google 上完全搜尋不到:網站在 Google 上搜尋不到。
- Search Console 顯示「已找到」或「已檢索 - 目前尚未建立索引」:這些狀態是什麼意思。
- 換成新應用程式後流量下降:網站改版後流量下降。
- 您在選的是架站平台而不是框架:Wix、Squarespace 還是 WordPress 更利於 SEO。
- 您想要一個一開始就為被找到而建的網站:網站代理。
- 您想請人檢查並修復索引問題:SEO 與 GEO 代理。