URL 編碼是前端傳送中文參數時的必經之路,而 JavaScript 提供了好幾個長得很像但行為不同的函式,用錯就會出現亂碼。
escape() / unescape()
只對 @ * + / 與 A-Z、0-9、a-z 這些字元不編碼,其他非 ASCII 字元一律以 %XX 形式替換。
關鍵問題是:escape 並不是為 URI 設計的,它採用的是非標準的編碼方式,遇到中文時會依字元拆成 %uXXXX 的形式,而後端多數框架無法正確解 this 格式。因此當傳送頁與接收頁的編碼格式(Charset)不一致時——例如傳送頁是 GB2312、接收頁是 UTF-8——用 escape 傳中文就會產生亂碼。這個函式應該避免使用。
encodeURI() / decodeURI()
保留 ! @ # $ & * ( ) = : / ; ? + ' 與 A-Z、0-9、a-z 不編碼,其餘字元都會編碼。因為它會保留 / 與 ? 等 URI 結構字元,所以適合處理「整個 URL」。
encodeURIComponent() / decodeURIComponent()
編碼範圍最廣,只保留 A-Z、0-9、a-z 與 - _ . ! ~ * ' ( ),連 /、?、&、= 都會被編掉。因此它才是編碼「單一參數值」的正確選擇。
// 整個網址:用 encodeURI
var url = "https://example.com/search?q=" + encodeURIComponent("台灣 台北");
// → https://example.com/search?q=%E5%8F%B0%E7%81%A3%20%E5%8F%B0%E5%8C%97
// 反解單一參數
var val = decodeURIComponent("%E5%8F%B0%E7%81%A3");
一句話記法:組 URL 時,路徑用 encodeURI,參數值用 encodeURIComponent;escape 系列一律不要用。
最後補充一個容易忽略的細節:encodeURIComponent 不會編碼單引號 ',因此在把參數值拼進 HTML 屬性時仍可能造成 XSS。這種情況該做的是 HTML 轉義,而不是指望 URL 編碼。而若要解析目前頁面的 query string,直接用 URLSearchParams 會比手動切字串可靠得多,它會自動處理編解碼與重複參數的問題。