產品 SEO 與 GEO 代理 付費廣告代理 網站代理 轉換代理
運作方式 方案 常見問題 部落格 預約通話

SPA SEO:如何讓單頁應用程式被 Google 建立索引

更新於 · 閱讀約 8 分鐘

簡短回答 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 上看到了什麼?

依序做三項檢查:

  1. 查看原始 HTML。 打開一個頁面,按 Ctrl+U(Mac 上按 Cmd+Option+U),搜尋頁面上的一句話。如果找不到,不執行 JavaScript 的檢索器什麼也看不到。
  2. 查看 Google 轉譯後的版本。 Google 建議用複合式搜尋結果測試或 Search Console 中的網址審查工具來「check if the rendered HTML has all content you expect」(檢查轉譯後的 HTML 是否包含您預期的全部內容)。兩者都會顯示 Google 執行程式碼後的頁面,以及任何 JavaScript 錯誤。
  3. 數一數已建立索引的頁面。 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`
VueNuxt,預設使用伺服器端轉譯,「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 指南為用戶端應用程式提供了兩種解決辦法:

  1. 用 JavaScript 重新導向到伺服器會回傳真正 404 狀態碼的網址,例如 `/not-found`。
  2. 用 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,對所有檢索器都不再是問題。

您的情況不同?

繼續閱讀

下一篇Noindex 檢查:如何查看網頁是否設定了 noindex檢查單一網頁 noindex 的四種方法:網頁原始碼、回應標頭、瀏覽器擴充功能和 Google 的網址審查工具。每種方法能查到什麼、會漏掉什麼。

自己動手

可檢索性檢查清單:讓 Google 能造訪到每個頁面小型企業網站的可檢索性檢查清單:用免費工具找出孤立頁面、robots.txt 封鎖、失效連結、重新導向鏈和伺服器錯誤。

問我們一個問題

一句話就夠了。我們會以電子郵件回覆。

出處

  1. Google Search Central: Understand the JavaScript SEO basics
  2. Google Search Central: Fix search-related JavaScript problems
  3. Google Search Central: Dynamic rendering as a workaround
  4. Google Search Central: Fix lazy-loaded website content
  5. Google Crawling Infrastructure: Crawl budget management
  6. Bing Webmaster Blog: JavaScript, dynamic rendering, and cloaking (October 2018)
  7. Vercel: The rise of the AI crawler (December 2024)
  8. React: Creating a React App
  9. React Blog: Sunsetting Create React App
  10. Next.js Docs: Metadata and OG images
  11. Vue.js: Server-Side Rendering (SSR)
  12. Nuxt Docs: Rendering modes
  13. Nuxt Docs: SEO and meta
  14. Angular: Server and hybrid rendering
  15. Angular Universal repository (archived)
  16. Angular API: Meta
  17. Lovable Docs: Optimize your app for SEO and AI search
  18. Meta for Developers: A guide to sharing for webmasters
  19. Google Analytics Help: Enhanced measurement events