URL 網址編碼解碼器 | encodeURIComponent 與完整網址轉換

URL 百分比編碼 (Percent-encoding) 原理

統一資源定位器（URL，Uniform Resource Locator）是全球資訊網的基石。依據網際網路工程任務組（IETF）制定的 RFC 3986 規範，URL 僅允許包含特定的 ASCII 字元集合：

未保留字元 (Unreserved Characters)：英文字母（a-z, A-Z）、數字（0-9）、破折號（-）、底線（_）、半形句點（.）與波浪號（~）。
保留字元 (Reserved Characters)：具備特殊語法語義的符號（例如 ? 代表查詢字串開始、& 分隔參數、/ 分隔路徑等）。

任何非 ASCII 字元（如繁體中文、日語、Emoji 符號）或需要在參數值中攜帶的保留字元，都必須進行百分比編碼（Percent-encoding），即以一個百分比符號 % 後接兩個十六進位數字表示該位元組（例如 UTF-8 中文「台」編碼為 %E5%8F%B0）。

許多工程師在處理前端跳轉或 API 請求時常混淆此兩個 API：

比較項目	encodeURI	encodeURIComponent
設計用途	編碼整個 URL 字串	編碼 URL 中的單一參數值 (Query Component)
保留不編碼符號	`;/?:@&=+$,#` 等協議分隔符號	幾乎所有特殊字元皆編碼，僅保留 `-_.!~*'()`
典型應用場景	`window.location.href = encodeURI(fullUrl)`	`const url = base + '?q=' + encodeURIComponent(keyword)`
若錯誤使用的後果	若用於參數，參數中的 `&` 或 `=` 不會被編碼，導致解析被截斷	若用於完整網址，`http://` 中的 `:` 與 `/` 會被轉碼，導致網址失效

本工具提供「完整網址 (Full URL)」與「組件參數 (Component Mode)」兩種模式快速切換，自動套用正確的編碼策略。

常見問答

encodeURI 與 encodeURIComponent 有何核心差異？

encodeURI 用於編碼完整網址，會保留協定與路徑分隔字元（如 ://?#=&）；而 encodeURIComponent 則用於編碼網址參數值，會將所有特殊字元皆轉換為百分比編碼。

網址中的中文字元為何需要進行 URL 編碼？

RFC 3986 規定 URL 僅能使用 ASCII 字元集。非 ASCII 字元（如中文字）必須轉換為 UTF-8 位元組並以百分比格式（如 %E5%8F%B0）傳輸，以避免伺服器解析錯誤。

是否支援解析或編碼帶有空格的網址參數？

支援。工具能精準將空格轉換為 %20 或 +，並在解碼時自動相容還原為原始空格。

常見的 URL 保留字元包含哪些？

包含冒號 (:)、斜線 (/)、問號 (?)、井號 (#)、中括號 ([])、艾特符號 (@)、驚嘆號 (!)、金錢號 ($)、安培符號 (&)、單引號 (')、括號 (())、星號 (*)、加號 (+) 與等號 (=)。

連續多次編碼造成 %2520 該如何復原？

此為重複編碼（Double Encoding）問題。只要使用解碼功能連續進行兩次或多次解碼，即可順利還原原始文字。