為什麼 URL 中會有 %20%2F 這類字串

URL 只能安全使用特定字元。空白、非英文文字、值內的斜線、符號與保留字元,往往需要先做百分比編碼才能放進 URL。

如何為 API 與查詢參數進行 URL 編碼與解碼

DevToolKits 的 URL 編碼/解碼工具 能協助你將可讀文字轉成 URL 安全字串,並將既有的值解碼回文字。

範例:把搜尋關鍵字放進 URL

假設你想把搜尋關鍵字 Tokyo Station cafe 放進 URL。空白在某些環境下可能造成顯示或複製時出錯。

Tokyo Station cafe

URL 編碼後會變成:

Tokyo%20Station%20cafe

放進查詢參數後,就成為可分享的 URL:

https://example.com/search?q=Tokyo%20Station%20cafe

確認它能解碼回原始字串,有助於發現搜尋條件出錯或文字毀損。

編碼何時重要

在建立搜尋 URL、回呼 URL、API 查詢參數、重新導向目標與追蹤連結時,編碼尤其重要。若值未正確編碼,瀏覽器或伺服器可能會在錯誤的字元處切割,並把它解讀成不同的參數。

例如,空白依情境可能呈現為 %20+。查詢值內的斜線可能需要與路徑中的斜線採取不同處理。

另外檢查查詢字串

當 URL 有許多參數時,使用 URL 參數 JSON 轉換工具 把查詢字串拆成鍵與值。這能讓你在分享或部署前,更容易審查追蹤連結與 API 請求。

總結

URL 編碼是個小細節,卻能避免連結損壞、API 請求格式錯誤與追蹤錯誤。收到的就解碼、要送出的就編碼,並盡可能把長查詢字串當作結構化資料來審查。

常見問題

%20+ 都是空白嗎?

兩者都代表空白,但情境不同。在 URL 路徑與百分比編碼中,空白是 %20。在查詢字串(application/x-www-form-urlencoded)中,空白可能以 + 表示。請確認你的 API 或表單預期的格式,並用 URL 編碼/解碼工具 驗證實際送出的字串。

如何分辨雙重編碼?

% 作為值的一部分時通常會被編碼成 %25。若解碼結果含有 %25,或解碼一次後仍無法回到原始 URL,很可能是把已編碼的值再次編碼的「雙重編碼」。解碼一次並確認是否回到預期的 URL,有助於釐清原因。

URL 中的非英文字元一定要編碼嗎?

網址列可能會直接顯示,但在以連結分享或傳給 API 時,請編碼以避免因環境而毀損。例如,東京 會被編碼為其 UTF-8 位元組序列 %E6%9D%B1%E4%BA%AC