萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

AJAX 傳遞中文參數完整指南:encodeURI vs encodeURIComponent 選型與後端解碼

URL 中傳遞中文等非 ASCII 字符必須經過百分號編碼。本文對比 escape、encodeURI、encodeURIComponent 三者差異,說明前後端協作的正確姿勢,並提供通用封裝函數。

三大編碼函數核心差異

函數不編碼字符適用場景備註
escape69 個:* + - . / @ _ 0-9 a-z A-Z**已棄用**不支援 Unicode 完整編碼,產生 %uXXXX 非標準格式
encodeURI82 個:! # $ & ' ( ) * + , - . / : ; = ? @ _ ~ 0-9 a-z A-Z**編碼完整 URL**保留 URL 結構字符(/ ? & =),不適用於單一參數值
encodeURIComponent71 個:! ' ( ) * - . _ ~ 0-9 a-z A-Z**編碼單一參數值**(推薦)會編碼 & = ? / 等結構字符,最安全

正確姿勢:前端 encodeURIComponent + 後端自動解碼

// 前端:構建查詢字符串
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**。手動解碼反而可能導致雙重解碼錯誤。

表單提交(application/x-www-form-urlencoded)

<form method="GET"> 或 POST 時,瀏覽器自動對表單字段執行 encodeURIComponent 並用 & 連接。後端同樣自動解碼。

JSON 請求體(application/json)

**無需 URL 編碼**。直接發送 UTF-8 JSON 字串,後端用 JSON 解析器處理。

歷史遺留專案:指定 charset=GBK

若老系統要求 GBK,前端需 encodeURI(encodeURI(str)) 雙重編碼(瀏覽器按頁面編碼發送),後端 new String(bytes, "ISO-8859-1").getBytes("GBK") 反解。**強烈建議全站統一 UTF-8 避免此坑。**

copyright © 萬盛學電腦網 all rights reserved