URL 中傳遞中文等非 ASCII 字符必須經過百分號編碼。本文對比 escape、encodeURI、encodeURIComponent 三者差異,說明前後端協作的正確姿勢,並提供通用封裝函數。
| 函數 | 不編碼字符 | 適用場景 | 備註 |
|---|---|---|---|
escape | 69 個:* + - . / @ _ 0-9 a-z A-Z | **已棄用** | 不支援 Unicode 完整編碼,產生 %uXXXX 非標準格式 |
encodeURI | 82 個:! # $ & ' ( ) * + , - . / : ; = ? @ _ ~ 0-9 a-z A-Z | **編碼完整 URL** | 保留 URL 結構字符(/ ? & =),不適用於單一參數值 |
encodeURIComponent | 71 個:! ' ( ) * - . _ ~ 0-9 a-z A-Z | **編碼單一參數值**(推薦) | 會編碼 & = ? / 等結構字符,最安全 |
// 前端:構建查詢字符串
const params = {
username: '張三',
content: '你好&世界'
};
const query = Object.entries(params)
.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
.join('&');
// 結果: username=%E5%BC%B5%E4%B8%89&content=%E4%BD%A0%E5%A5%BD%26%E4%B8%96%E7%95%8C
fetch(`/api?${query}`).then(...);
現代框架(Spring Boot、Express、Django、Laravel、ASP.NET Core)**自動對 query string 進行 UTF-8 解碼**,**無需手動 urldecode**。手動解碼反而可能導致雙重解碼錯誤。
<form method="GET"> 或 POST 時,瀏覽器自動對表單字段執行 encodeURIComponent 並用 & 連接。後端同樣自動解碼。
**無需 URL 編碼**。直接發送 UTF-8 JSON 字串,後端用 JSON 解析器處理。
若老系統要求 GBK,前端需 encodeURI(encodeURI(str)) 雙重編碼(瀏覽器按頁面編碼發送),後端 new String(bytes, "ISO-8859-1").getBytes("GBK") 反解。**強烈建議全站統一 UTF-8 避免此坑。**