C++如何实现字符串的按URL编码规范转义-C++-PHP中文网

url编码是按rfc 3986将非保留字符（空格、中文等）转为%xx大写十六进制格式，保留a-z、a-z、0-9及-_.~；不能直接用std::hex因它不处理utf-8多字节、易符号扩展、未过滤保留字符且不保证两位补零。

c++如何实现字符串的按url编码规范转义

什么是URL编码，为什么不能直接用 `std::hex` 或手写查表

URL编码（Percent-encoding）要求：将非保留字符（如空格、中文、特殊符号）转为 %XX 形式，其中 XX 是该字节的十六进制大写表示；字母 a–z、A–Z、数字 0–9 以及 -_.~ 保持原样；斜杠 /、问号 ? 等保留字符在路径/查询中通常不编码（除非语义需要），但标准库不做上下文判断——所以你得自己决定编码范围。

常见错误是只处理 UTF-8 的单字节，或把整个字符串当 std::wstring 转宽字符再编码，结果对中文输出乱码 %E4%B8%AD%E6%96%87 反而正确，但用 wchar_t + std::codecvt_utf8（已弃用）或盲目调 std::to_string 就会崩。

关键点：URL编码操作对象是字节序列，不是字符。UTF-8 字符串本身就是字节流，直接遍历每个 unsigned char 即可。

用 `std::ostringstream` + `std::hex` 安全转义 ASCII 范围外字节

对每个字节，判断是否属于 unreserved 字符集（0-9a-zA-Z-_.~），否则格式化为 %XX。注意：必须用 unsigned char 强转，否则 char 为负时 std::hex 会输出补码高位（如 0xFF 变成 ffffffff）。

用 std::ostringstream 避免手动拼接 std::string 导致多次 realloc
std::hex + std::uppercase + std::setw(2) + std::setfill('0') 组合控制输出格式
不要用 sprintf 或 snprintf，C 风格易溢出且无类型安全

#include <sstream>
#include <iomanip>
#include <cctype>

std::string url_encode(const std::string& s) {
    std::ostringstream ret;
    for (unsigned char c : s) {
        if (std::isalnum(c) || c == '-' || c == '_' || c == '.' || c == '~') {
            ret (c);
        }
    }
    return ret.str();
}
</cctype></iomanip></sstream>

为什么 `curl_easy_escape` 或 `libcurl` 不推荐用于通用场景

libcurl 的 curl_easy_escape 确实能做 URL 编码，但它：内部使用 malloc 分配内存，返回 char*，调用者必须记得 curl_free；它默认把空格编码为 + （application/x-www-form-urlencoded 风格），而非标准 %20；且依赖外部链接，在嵌入式或纯头文件项目里引入重量级依赖不划算。

更隐蔽的问题是：它对输入字符串长度无检查，若传入未终止的缓冲区会越界读；而且它不区分 URI path 和 query，无法按需保留 / 或 ? ——这些逻辑得你额外封装。