每一個本地化頁面都需要完整的設定嗎？

是的。必須包含所有替代版本加上當前頁面本身，並確保所有替代版本相互連結。

x-default 是什麼意思？

它標示一個降級頁面，用於針對語言或地區設定與任何列出的替代版本均不匹配的使用者。

不。它驗證的是保守的標籤形狀與大小寫；請分別確認註冊支援與內容對標。

Hreflang 產生器會為等價內容的本地化或區域版本產生 HTML 連結元素。請以垂直條線分隔，每行輸入一個語言與完整 URL。該工具將為每一行產生一個 rel=alternate 元素，可直接放入該語言群組中所有頁面的 head 中。

每一個本地化版本都應發布完整的連結集合，包含指向自身的連結。不同版本之間應相互指向。Google 將這些自我連結與回傳連結視為關鍵訊號；單向宣告可能被忽略，因為其他網站無法單方面聲稱你的頁面為其替代版本。

網址必須是包含主機的完整 http 或 https 位址。相對參照與省略通訊協定的相對參照都會遭到拒絕。認證資訊與片段識別碼也會遭到拒絕。瀏覽器 URL 解析器會將位址標準化，而在產生的 HTML 中，& 符號和其他對屬性敏感的字元都會經過逸出處理。

語言輸入支援兩字母語言、可選的四字母書寫系統與可選的兩字母地區。大小寫會標準化，例如 en-us 會轉為 en-US，zh-hant 會轉為 zh-Hant。特殊 x-default 標籤可用於當使用者設定與任何列出的語言或地區均不匹配時的降級頁面。

頁面僅驗證語言標籤的結構，而非特定搜尋引擎所支援的完整 ISO 語言與國家程式碼清單。結構正確的標籤仍可能不被支援或不適用。在部署前，請針對所有預期語言與地區與 Google 的最新檔案以及實際內容受眾進行確認。

地區程式碼不能單獨作為第一個子標籤；第一個子標籤代表語言。地區針對性應放在語言之後，例如 fr-CA。當存在多個國家特定的法語版本時，使用如 fr 之類的通用語言頁面作為降級頁面會很有幫助。書寫系統子標籤可區分不同書寫系統，例如 zh-Hans 與 zh-Hant。

x-default 不代表一種語言，它標示的是針對語言或地區設定與任何列出的替代版本均不匹配的使用者的頁面，常見於國家選擇器或通用首頁。僅允許出現一個 x-default 設定，且在大小寫不敏感的情況下，重複的語言值將被拒絕。

Hreflang 並不翻譯內容、偵測語言或保證搜尋結果。Google 可能會根據多種訊號自動判斷頁面語言並選擇結果。這些標籤僅描述等價本地化版本之間的關係，並非翻譯內容或國際化架構的替代品。

該產生器最多支援 100 行，且至少需要兩行，包含當前頁面。每行必須僅含一個分隔符。若輸入格式錯誤，整個集合將被拒絕，以避免部分輸出被複製，同時靜默忽略某個國家或語言版本。

八個符合標準的測試案例涵蓋通用語言、區域大小寫、德語與法語地區、簡體與繁體中文書寫標籤、語言-書寫-地區組合以及 x-default。額外測試確認 HTML 的精確轉義，拒絕重複、相對 URL、片段、帳號與不完整的單行設定。

要使用它，請清單列出所有相等的本地化頁面，包含目前正在編輯的 URL，並僅在存在真正的備選頁面時才加入 x-default。產生標籤後，將相同的區塊安裝在每個頁面的 head 中，並為每個語言測試提供的 HTML。確認每個替代頁面會傳回有用的 200 頁面。

請勿將不一致的 hreflang 設定跨 HTML、HTTP 頭與 XML 網站地圖進行組合。Google 會將這些實現方式視為等效，維持多個複製版本可能導致資料不同步。請選擇你的發布系統能完整且同步維護的方法。本工具專門產生 HTML 的 head 元素。

部署後，從每個語言群組中抽取樣本並機械化比對結果。該工具無法訪問遠端頁面，亦無法驗證相互連結。持續品質取決於當新增、移除、重定向或遷移至新標準 URL 時，所有版本皆能同步更新。

行以單一字元 | 分隔，語言標籤限制為語言加上可選的語系與地區，並以 Intl.getCanonicalLocales 進行標準化，x-default 有明確處理，URL 會轉為無片段、無憑證的 HTTP(S) 形式，屬性則以 HTML 進行轉義。