用 JavaScript 提交資料時,特別是包含中文的時候,經常需要把字串做 URL 編碼。JS 提供了三個相關函式:escape、encodeURI、encodeURIComponent。其中 escape 在舊程式碼裡出現頻率最高,但它恰恰是最不該用的那一個。
encodeURI:對整個 URL 做編碼,但保留 URL 中具有結構意義的字元::、#、/、\、=、& 等。適合處理「完整網址」。
encodeURIComponent:對字串中的所有字元編碼,包括上述 URL 特殊字元。適合處理「要放進 URL 的單一參數值」。
escape:JS 早期版本就存在的函式,處理 Unicode 字元時會有問題,且不符合 URL 編碼規範。
var url = "https://www.abc.com?q=aa&b=呵呵"; var encodedUrl = encodeURI(url); alert(encodedUrl); //輸出:https://www.abc.com?q=aa&b=%E5%91%B5%E5%91%B5 encodedUrl = encodeURIComponent(url); alert(encodedUrl); //輸出:http%3A%2F%2Fwww.abc.com%3Fq%3Daa%26b%3D%E5%91%B5%E5%91%B5 alert(escape(url)); //輸出:http%3A//www.abc.com%3Fq%3Daa%26b%3D%u5475%u5475
三個結果的差異一目了然:
encodeURI 保留了 ://、?、=、&,只把中文編碼——因為它假定你處理的是一整個 URL。encodeURIComponent 把冒號、斜線、問號、等號、& 全部編碼,是最徹底的轉義。escape 把中文轉成 %u5475 這種形式,這不是 URL 編碼的格式(URL 編碼用的是 UTF-8 位元組的 %E5%91%B5),而且連斜線都沒有編碼。沒有特殊理由的話,用 encodeURIComponent 編碼、decodeURIComponent 解碼。因為它編碼最徹底,不會讓參數值中的 &、= 破壞 query string 的結構。
也許你用 escape 一直沒出問題——可能是後端語言剛好也能解析 %uXXXX,或資料裡剛好沒有特殊字元。但這個函式在處理 Unicode 時並不符合標準,遇到不同伺服器環境就可能翻车,沒有理由繼續使用。事實上 escape 與 unescape 已被標記為 deprecated。
1. 組 query string 時,key 與 value 都要編碼。
var params = "name=" + encodeURIComponent("張三&李四")
+ "&age=" + encodeURIComponent(30);
var url = "/search?" + params;
2. 不要對整個 URL 用 encodeURIComponent。那會把 https:// 也編碼掉,導致連結失效。整段 URL 要編碼時用 encodeURI,但更好的做法是分開處理各個參數。
3. 用 URLSearchParams 會更輕鬆。它自動處理編碼與串接:
var search = new URLSearchParams();
search.set("name", "張三&李四");
search.set("age", 30);
var url = "/search?" + search.toString();
// 讀取時
var name = search.get("name"); // 自動解碼
4. 注意 encodeURIComponent 不編碼的字元。它會保留 A-Z a-z 0-9 - _ . ! ~ * ' ( )。其中 !、*、'、(、) 在 RFC 3986 中屬於保留字元,若後端解析嚴格,可能需要額外處理:
function strictEncode(str){
return encodeURIComponent(str)
.replace(/[!'()*]/g, function(c){
return '%' + c.charCodeAt(0).toString(16).toUpperCase();
});
}
5. 表單不要用 GET 傳中文。中文或大量資料應改用 POST 搭配 application/x-www-form-urlencoded 或 multipart/form-data,由瀏覽器或 fetch 處理編碼細節。
總結:三個函式中,encodeURIComponent / decodeURIComponent 是編碼參數值的正確工具,encodeURI 保留 URL 結構、用於整段網址,而 escape 請直接遺忘。