本文提到的工具
邊閱讀邊在瀏覽器中開啟工具,立即試試整個流程。

「這段長長的 URL,裡面裝了什麼?」
排列在瀏覽器網址列中,那段彷彿深不見底的字串。
一連串如 %E3%81%82... 般的符號,以及由 & 串接起的無數參數。
您是否曾覺得「這就算對工程師來說,光看一眼也看不懂啊!」而感到氣餒呢?
在網頁開發中,URL 不僅僅是位址,更是系統間交換重要資訊的「留言板」。讓我們一起整理如何能聰明地解讀其中的內容。
為什麼 URL 會變得像是「咒語」?
實際上,URL 中能使用的字元非常有限。僅限於英數字以及少數的符號。
若想直接傳送中文(多位元組字元)、空格,甚至是 & 或 = 等具有特殊含義的符號,在傳輸過程中就會產生「咦,參數到哪裡結束?」的混亂。
因此,我們會將特殊字元替換成以 % 開頭加上數字的組合,這就是 百分比編碼 (Percent-Encoding)。那段如同咒語般的外觀,其實是前人為了「在任何環境下都能安全傳遞資訊」所留下的智慧。
查詢參數如同「巨大的積木」
在研究 API 或查看行銷追蹤標籤 (UTM 參數) 時,有時會看到 10 個、20 個參數連在一起的情況。
?utm_source=google&utm_medium=cpc&utm_campaign=...
要從橫向一行字中解讀出其中的含義,可說是難如登天。
但如果這被整理成 JSON 格式,結果又會如何呢?
{
"utm_source": "google",
"utm_medium": "cpc",
"utm_campaign": "spring_sale"
}
您肯定能瞬間察覺:「啊,這裡寫錯了」。
將 URL 參數轉成 JSON 的步驟
調查很長的 URL 時,先把查詢字串拆開,確認鍵與值的對應。從瀏覽器網址列、存取日誌、廣告管理畫面、API 用戶端等處複製的 URL,都可以直接使用。
- 複製要調查的 URL,或只複製
?之後的查詢字串。 - 貼到 URL 參數 → JSON。
- 確認已轉成 JSON 的鍵與值。
- 檢查是否有不需要的參數、重複,或編碼損壞。
例如,假設有下面這個 URL。
https://example.com/search?q=markdown%20table&utm_source=google&page=2
轉成 JSON 後,就變得容易閱讀。
{
"q": "markdown table",
"utm_source": "google",
"page": "2"
}
q 中的搜尋詞、utm_source 的流量來源、page 的頁碼都分開呈現,除錯與分享會輕鬆許多。
URL 除錯時要確認的重點
URL 參數只差一個字元,行為就可能改變。檢查以下項目,就更容易找出網頁應用程式或追蹤標籤的問題。
- URL 中是否出現多個
? - 參數是否以
&正確分隔 - 是否有重複的相同鍵
- 中文與空白是否正確編碼
utm_source、utm_medium、utm_campaign的值是否如預期- API 所期待的鍵名與實際鍵名是否一致
尤其是廣告 URL 與電子郵件發送用的 URL,在複製或串接的過程中,可能會漏掉 & 或被重複編碼。光是轉成 JSON 並排檢視,就能大幅加快釐清原因的速度。
在 DevToolKits 中將 URL 「視覺化」
DevToolKits 提供了將 URL 這這組「暗號」轉化為「資訊」的工具:
- URL 編碼/解碼:將如同咒語般的
%表示法,還原成對人類親切的語言。反之,當您想建立包含中文的路徑時,也能瞬間將其轉換為安全的格式。 - URL 參數轉 JSON:只需貼上長長的查詢字串,即可將其重新組合成整齊的 JSON。這對於偵錯複雜的請求而言,是再強大不過的支援。
結語
URL 是網頁最基礎中的基礎,卻也是個深奧的世界。
透過理解其原理並使用合適的工具將其「視覺化」,您的開發效率將獲得顯著提升。
當您「不再害怕長串 URL」的時候,或許就是您作為工程師更上一層樓的瞬間。
常見問題
可以把包含查詢字串的整個網址貼上嗎?
可以。URL 參數轉 JSON 與 URL 編碼/解碼 都在瀏覽器內處理,貼上的內容不會傳送到伺服器。不過,含有存取權杖或工作階段 ID 的網址本身就是機密,處理完之後請避免把它留在聊天記錄或問題追蹤系統中。
為什麼中文會顯示成 %E4%B8%AD 這樣?
這是百分比編碼。網址只能使用有限的 ASCII 字元,因此中文、表情符號、空白等字元會先轉成 UTF-8 位元組,再以 % 加上兩位十六進位數字表示。%E4%B8%AD 就是「中」這個字的三個位元組。解碼後就會變回可讀的文字。
同一個參數名稱出現多次會怎樣?
這是合法的,如何解讀取決於接收端的應用程式。許多框架會把值收集成陣列,核取方塊群組通常就是這樣送出的。本站的轉換工具也遵循同樣規則:重複的鍵會變成陣列,因此一眼就能看出是否有重複。
encodeURI 與 encodeURIComponent 有什麼差別?
encodeURI 不會編碼在網址中具有結構意義的字元(/、?、&、#),適合用於整個網址;encodeURIComponent 連這些字元也會編碼,適合用於單一參數值。對含有 & 的值誤用 encodeURI,查詢字串就會被破壞,這是最常見的錯誤之一。
