UD5工具箱
使用教程
第一步：了解URL编码的基本概念
在使用工具之前，建议先了解URL编码的基本原理。URL编码（Percent-Encoding）是将字符转换为%加两位十六进制数的表示方式。例如，空格字符的ASCII码是32（十六进制20），所以编码为%20。中文字符采用UTF-8编码后，每个汉字会被转换为3个字节，每个字节再单独进行百分号编码。例如"你好"编码为%E4%BD%A0%E5%A5%BD。了解这些基本概念后，你就能更好地理解工具的编解码结果。
第二步：选择编码模式
打开工具页面后，首先根据你的需求选择编码模式。如果你需要编码URL中的某一个查询参数值（例如搜索关键词、用户名、密码等），请选择encodeURIComponent模式。这个模式最为安全，会将所有可能破坏URL结构的特殊字符都进行编码。如果你需要编码整个URL地址（例如对一个完整的包含域名、路径、参数的URL进行编码），请选择encodeURI模式，它会保留URL的结构完整性。模式切换按钮位于界面上方，点击即可在两种模式之间切换。
第三步：输入待编码文本
在左侧的输入面板中，输入你需要编码的原始文本。可以是单个参数值（如"hello world"或"中文测试"），也可以是完整的URL字符串（如"https://example.com/search?q=关键词&page=1"）。面板支持多行文本输入，即使是很长的文本也能正常处理。输入过程中，界面下方的字符计数器会实时更新，显示当前输入的字符总数。
第四步：执行编码操作
文本输入完成后，点击"编码"按钮，工具会立即在右侧面板中显示编码后的结果。编码过程在浏览器本地毫秒级完成，即使是数千字符的长文本也不会有任何延迟。你可以对比左右两个面板，直观地查看每个字符被编码后的形式。如果发现编码结果不符合预期，可以切换模式重新编码，或者检查原始文本中是否包含了不需要编码的字符。
第五步：执行解码操作（反向操作）
如果你有一段已编码的URL字符串需要还原为原始文本，可以在右侧面板中输入已编码的字符串，然后点击"解码"按钮，左侧面板就会显示解码后的原始文本。解码操作同样支持encodeURIComponent和decodeURI两种模式，确保与编码模式对应。如果编码和解码模式不匹配，可能会导致解码结果不正确，此时请检查并调整模式选择。
第六步：复制结果
编解码完成后，点击结果面板旁边的复制按钮，即可将结果复制到系统剪贴板。按钮点击后会有状态变化提示，确认复制成功。之后可以直接在代码编辑器、浏览器地址栏、API测试工具等任何地方使用Ctrl+V粘贴结果。这一功能在批量处理多个URL参数时尤其高效，避免了反复手动选择和复制的繁琐操作。
第七步：利用参考表核对结果
页面下方的常用URL编码字符参考表可以帮助你快速核对编码结果。表格列出了12个最常见的编码字符及其对应的百分号编码值。例如，如果你编码后看到%20，可以对照表格确认这是空格字符的编码。对于中文字符，你可以查看其UTF-8编码的百分号形式，确保每个字节都被正确编码。参考表是静态展示，可以随时查阅，非常适合在编解码过程中作为快速验证工具使用。
第八步：加载示例学习使用方法
如果你是首次使用本工具，或者想了解更高级的编解码场景，可以点击"加载示例"按钮。示例文本涵盖了常见的使用场景，包括带空格的搜索关键词、包含特殊符号的文件名、中文URL路径、包含多个参数的查询字符串等。通过观察示例文本的编码结果，你可以快速掌握不同类型字符的编码规律，为实际工作中的URL编解码打下坚实基础。
实际应用场景示例
场景一：构建API请求URL。当你需要向API发送包含中文搜索词的请求时，先使用encodeURIComponent编码搜索词，然后拼接到URL的查询参数中。例如搜索词"人工智能"编码后为%E4%BA%BA%E5%B7%A5%E6%99%BA%E8%83%BD，完整的请求URL为https://api.example.com/search?q=%E4%BA%BA%E5%B7%A5%E6%99%BA%E8%83%BD。
场景二：解析第三方URL参数。当你收到一个包含编码参数的URL时，使用解码功能提取原始值。例如从redirect_url=https%3A%2F%2Fexample.com%2Fcallback%3Ftoken%3Dabc123中解码得到原始的重定向地址和token值。
场景三：处理表单提交数据。浏览器在POST请求体中会使用application/x-www-form-urlencoded格式编码表单数据，其中空格被编码为+号。使用工具可以方便地在两种编码格式之间进行转换和核对。