Hreflang 標籤是多語言與多地區網站進行搜尋引擎最佳化（SEO）的重要工具。當網站針對不同國家或語言的用戶提供多個網頁版本時，搜尋引擎需要明確的訊號來理解這些網頁之間的對應關係。透過在網頁中加入 rel="alternate" hreflang="xx" 屬性，網站管理員、SEO 專業人員與網頁開發者可以明確告知搜尋引擎每個語系版本的定位，確保搜尋引擎將正確的語言或地區 URL 呈現給對應的搜尋用戶。
本工具旨在協助您快速且正確地建立這些標籤，避免手動撰寫時常出現的語法錯誤。
Hreflang 標籤的結構與 ISO 代碼規範
一個標準的 hreflang 屬性必須遵循嚴格的國際標準代碼格式。本工具在產生標籤時，會嚴格驗證以下三種代碼：
- ISO 639-1 語言代碼：必須為兩碼的小寫語言代碼（例如
en、zh）。 - ISO 15924 文字代碼：選填，用於區分同一語言的不同書寫系統（例如
zh-Hant代表繁體中文，zh-Hans代表簡體中文）。 - ISO 3166-1 Alpha-2 地區代碼：選填，必須為兩碼的大寫國家或地區代碼（例如
US、TW）。
在實際應用中，這些代碼可以組合使用，例如 zh-Hant、zh-CN 或 zh-Hans-US。本工具會自動將輸入的字母大小寫進行標準化處理（例如將 EN-us 轉換為 en-US），並對 URL 中的查詢參數（Query Parameters）進行轉義，以確保輸出的標籤完全符合搜尋引擎的解析規範。
x-default 屬性的角色與設定
在多語言架構中，x-default 是一個特殊的 hreflang 值。它扮演著「回退機制」（Fallback）的角色。當造訪網站的用戶，其瀏覽器語言或所在地區在您設定的特定語系清單中找不到精確匹配的版本時，搜尋引擎就會引導用戶前往 x-default 所指定的 URL。
通常，x-default 會指向一個全域首頁、語言選擇頁，或是網站最主要使用的語言版本頁面。在本工具中，您可以自由選擇是否填入此欄位，以完善您的國際化 SEO 配置。
標籤產生器的運作規則與限制
為了確保產生的程式碼完全無誤，本工具內建了嚴格的即時驗證機制。只有當所有輸入欄位都通過驗證時，系統才會產生對應的標籤；若有任何錯誤，輸出區域將保持空白。
以下為工具的運作規則與限制：
- 數量限制：本編輯器一次最多支援 100 個語言版本。
- URL 長度限制：每個輸入的 URL 長度必須少於 2,048 個字元。
- 通訊協定要求：所有網址必須是包含
http://或https://的完整 URL。 - 代碼限制：工具不支援
es-419（拉丁美洲西語）等非標準兩碼地區代碼，亦不接受未定義的無效代碼。 - 重複檢查：同一個
hreflang代碼在同一組設定中不得重複出現。
錯誤訊息與排查指南
當輸入的資料不符合規範時，工具會顯示對應的錯誤提示，請根據以下訊息進行修正：
- 請至少新增兩個語言版本。
- 版本
{index}缺少語言或語言-地區代碼。 - 版本
{index}缺少完整 URL。 - 版本
{index}必須使用兩碼語言代碼，可選擇再加上一個 ISO 15924 文字代碼和／或一個兩碼地區代碼。 - 版本
{index}中的{code}不是 ISO 639-1 語言代碼。 - 版本
{index}中的{code}不是 ISO 3166-1 Alpha-2 地區代碼。 - 版本
{index}中的{code}不是有效的 ISO 15924 文字代碼。 - 版本
{index}重複使用了 hreflang 代碼{locale}。 - 版本
{index}需要完整的 http:// 或 https:// URL。 - 版本
{index}的 URL 必須少於 2,048 個字元。 - 請填入 x-default 使用的 URL。
- x-default 需要完整的 http:// 或 https:// URL。
- x-default URL 必須少於 2,048 個字元。
- 此編輯器一次最多支援
{max}個語言版本。
隱私與資料處理說明
本工具完全在您的用戶端瀏覽器中進行即時運算與驗證。您所輸入的所有網址、語言代碼及相關設定，絕不會上傳到 BroBroGo 的伺服器，確保您的網站架構與未公開的網址資訊保有隱私。
常見問題
這個工具接受哪些 hreflang 代碼？
語言部分使用兩碼 ISO 639-1 代碼，之後可再依序加上一個 ISO 15924 文字代碼和／或一個兩碼 ISO 3166-1 地區代碼，例如 en、zh-Hant、zh-CN、zh-Hans-US。輸出會自動統一字母大小寫。
產生的標籤應該放在哪裡？
把同一組完整標籤原樣放進每個多語系版本的 <head> 區段中。每個頁面都要同時指向自己和其他版本。
x-default 應該指向哪個頁面？
請選擇語言或地區沒有精確相符時希望訪客進入的頁面，可以是語言選擇頁、全球首頁或主要語言版本。