JavaScript 提供了三個看似相似、實則用途完全不同的編碼函數。選錯一個,中文參數就可能變成服務端讀不懂的亂碼。
采用 ISO Latin 字符集對字符串進行編碼。所有空格、標點、特殊字符以及其他非 ASCII 字符都會被轉換成 %xx 形式(xx 是該字符在字符集中編碼的十六進制值),例如空格對應 %20。
不會被編碼的字符: @ * / +
注意:escape 不適用於 URI,對於非 ASCII 字符(如中文)它使用的是 UTF-8 之外的編碼方式,因此已經不建議在新代碼中使用。
把字符串以 UTF-8 編碼後轉成 escape 格式,同時保留 URI 的結構字符,適合處理一整條完整的 URL。
不會被編碼的字符: ! @ # $ & * ( ) = : / ; ? + '
同樣使用 UTF-8,但比 encodeURI 編碼更多的字符,連 / 也會被編碼成 %2F。因此它適用於編碼「URL 的某一部分」,比如查詢參數的值。
不會被編碼的字符: ! * ( ) '
如果字符串本身包含 URI 的多個部分(例如整條帶路徑與參數的 URL),就不能用它,否則 / 被編碼後 URL 結構就壞了。
encodeURIComponent()。無論 GET 拼接查詢串還是 POST 提交表單數據,編碼單個參數值時它都是正確選擇。encodeURI()。escape;而如果頁面是 GB2312、接收參數的頁面是 UTF-8,就必須用 encodeURI 或 encodeURIComponent,因為它們會先把字符轉成 UTF-8 字節。var url = "https://example.com/search?q=中文 參數";
encodeURI(url);
// https://example.com/search?q=%E4%B8%AD%E6%96%87%20%E5%8F%82%E6%95%B0
// 注意 ? = 等結構字符被保留
encodeURIComponent("中文 參數");
// %E4%B8%AD%E6%96%87%20%E5%8F%82%E6%95%B0
// 空格編碼為 %20,適合作為參數值
encodeURIComponent("a/b");
// a%2Fb 斜槓被編碼,所以它不能拿來編碼整條路徑
今天的最佳實踐是:全站統一 UTF-8,拼接查詢串時直接用 URLSearchParams 或 URL 構造函數,它們內部已按 application/x-www-form-urlencoded 規則處理好編碼,比手工調用編碼函數更不容易出錯。