C#实现Escape和Unescape函数及调用方法

结果或目标

在Web开发或数据传输场景中，常需对特殊字符进行URL编码以确保安全性或兼容性。目标是获取一个完整的C#解决方案，既能处理常规字符编码，又能准确还原。

准备条件

• 已安装支持C#的.NET开发环境（Visual Studio或兼容IDE）。
• 引入必要的命名空间：System.Text用于StringBuilder，System用于Uri。

真实操作顺序

第1步：自定义Escape函数进行编码

目的：遍历字符串，将非字母数字及特定保留字符转换为百分号编码格式。

核心逻辑：利用Uri.HexEscape方法，仅对不安全的字符进行转换，提升性能并减少输出长度。

public static string Escape(string str)
{
    StringBuilder sb = new StringBuilder();
    foreach (char c in str)
    {
        // 保留字母、数字及部分安全字符，其余转为Hex编码
        bool isSafeChar = Char.IsLetterOrDigit(c) 
            || c == '-' || c == '_' || c == '\\' 
            || c == '/' || c == '.';
        
        if (isSafeChar)
            sb.Append(c.ToString());
        else
            sb.Append(Uri.HexEscape(c));
    }
    return sb.ToString();
}

第2步：自定义Unescape函数进行解码

目的：识别输入字符串中的十六进制编码序列，并将其还原为原始字符。

核心逻辑：使用Uri.IsHexEncoding检测当前位置是否为编码起点，若是则调用Uri.HexUnescape解析。

public static string UnEscape(string str)
{
    StringBuilder sb = new StringBuilder();
    int len = str.Length;
    int i = 0;
    
    while (i != len)
    {
        // 检查当前指针位置是否开始于Hex编码
        if (Uri.IsHexEncoding(str, i))
        {
            sb.Append(Uri.HexUnescape(str, ref i));
        }
        else
        {
            sb.Append(str[i++]);
        }
    }
    return sb.ToString();
}

第3步：使用Microsoft.JScript内置方法（备选）

目的：若项目中已引用相关库，可直接调用现成的全局对象方法，简化代码。

入口：需在项目中添加对Microsoft.JScript.dll的引用，并在代码中引入Microsoft.JScript.GlobalObject。

// 示例用法
string encoded = Microsoft.JScript.GlobalObject.escape("测试内容");
string decoded = Microsoft.JScript.GlobalObject.unescape(encoded); 

完成判断

• 功能验证：执行Escape后，特殊字符应显示为以%开头的十六进制组合（如空格变为%20）。
• 闭环验证：将Escape的输出作为UnEscape的输入，返回值应与原始字符串完全一致。
• 异常处理：确保处理空字符串或非ASCII字符时程序无崩溃。

原文有依据的排错

在使用Microsoft.JScript方案时，若编译报错“未能找到类型或命名空间”，请检查项目是否缺少Microsoft.JScript的程序集引用，这通常需要在References中添加该COM或DLL组件。

简要总结

本文详细列出了C#中实现自定义Escape/Unescape函数的具体步骤，并通过对比展示了使用系统级Uri类的优势。同时提供了依赖Microsoft.JScript的快速调用路径，开发者可根据项目架构自由选择最合适的方案来解决字符串编码问题。