萬盛學電腦網

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

JavaScript 與 C# 編碼解碼完整指南:escape、encodeURI、encodeURIComponent 差異與對應類別

前言

在前後端交互中,URL 參數傳遞與資料編碼是常見議題。JavaScript 提供 escape、encodeURI、encodeURIComponent 三種編碼函式,而 C# 則有 HttpUtility.UrlEncode、Server.UrlEncode 等對應方法。本文系統整理三者的編碼範圍、適用場景及跨語言對照表,助您避開亂碼陷阱。

一、JavaScript 三大編碼函式對比

函式不編碼字元數不編碼字元清單典型用途
escape 69 個 * + - . / @ _ 0-9 a-z A-Z 歷史資料儲存(如 history 紀錄),非 ASCII 字元輸出 %uXXXX 格式
encodeURI 82 個 ! # $ & ' ( ) * + , - . / : ; = ? @ _ ~ 0-9 a-z A-Z 整段 URL 跳轉(例:location.href = encodeURI(url))
encodeURIComponent 71 個 ! ' ( ) * - . _ ~ 0-9 a-z A-Z 單一參數值編碼,防止 #、& 等特殊字元截斷 URL

關鍵差異速記

  • escape:已棄用,僅維護舊專案;Unicode > 255 時產生 %uXXXX,其餘情況與另外兩者結果相同。
  • encodeURI:保留 URL 結構字元(:、/、?、# 等),適合對完整 URL 編碼。
  • encodeURIComponent:最嚴格,連結結構字元也會編碼,專為「參數值」設計。

二、對應的 C# 解碼/編碼類別

JS 函式C# 編碼C# 解碼備註
escape / unescape HttpUtility.UrlEncode HttpUtility.UrlDecode ASP.NET Core 建議使用 System.Net.WebUtility
encodeURI / decodeURI HttpUtility.UrlEncode HttpUtility.UrlDecode 實務上同 escape 對應,若需嚴格區分請自行實作
encodeURIComponent / decodeURIComponent HttpContext.Current.Server.UrlEncode HttpContext.Current.Server.UrlDecode 最常用於 API 參數傳遞

三、實戰範例

1. 整段 URL 跳轉(encodeURI)

// JS
location.href = encodeURI("https://cang.baidu.com/do/s?word=百度&ct=21");

2. 參數值編碼(encodeURIComponent)

// JS 動態產生帶參數的連結
document.write('<a href="https://passport.baidu.com/?logout&aid=7&u='
    + encodeURIComponent("https://cang.baidu.com/bruce42") + '">退出</a>');

3. C# 端接收與解碼

// ASP.NET WebForms / MVC
string param = HttpContext.Current.Server.UrlDecode(Request.QueryString["u"]);

四、最佳實踐建議

  1. 棄用 escape/unescape:現代專案一律改用 encodeURIComponent + decodeURIComponent。
  2. 雙端統一編碼格式:前後端約定皆使用 UTF-8,避免中文亂碼。
  3. 參數值務必用 encodeURIComponent:哪怕參數看起來「安全」,也要編碼,防止未來擴充時出現特殊字元。
  4. C# 端優先用 WebUtility:System.Net.WebUtility.UrlEncode/Decode 無需引用 System.Web,適合 .NET Core / Standard 專案。

五、快速查詢表

下表列出三種函式對常見特殊字元的編碼結果(✅ 表不編碼,🔴 表編碼):

字元escapeencodeURIencodeURIComponent
空格🔴 %20🔴 %20🔴 %20
#🔴 %23✅🔴 %23
&🔴 %26✅🔴 %26
=🔴 %3D✅🔴 %3D
?🔴 %3F✅🔴 %3F
/✅✅🔴 %2F
@✅✅✅
中文🔴 %uXXXX🔴 %E4%B8%AD%E6%96%87🔴 %E4%B8%AD%E6%96%87

掌握上述對照關係,即可在前後端協作中游刃有餘,徹底解決 URL 編碼亂碼問題。

copyright © 萬盛學電腦網 all rights reserved