std::unordered_map 是存储 url 参数最直接的容器，因其哈希查找高效、无需排序；键值均需正确 url 编码，避免双重编码或遗漏；推荐手写线程安全的 url_encode 函数而非 curl_easy_escape。
用 std::unordered_map 存 URL 参数最直接
URL 查询参数本质就是键值对，且不保证顺序、查多改少，std::unordered_map<:string std::string></:string> 是最匹配的容器。别用 std::map——它按字典序自动排序，但 URL 参数拼接不需要排序，纯属浪费 CPU 和内存。
注意两点：键名和值都必须做 URL 编码（尤其是空格、中文、&、=），否则拼出来的 URL 会解析失败或被截断。
- 编码函数不能只简单替换空格为
%20，得处理所有非字母数字及-_.~ - 常见错误是只编码值、漏掉键名；或者对已编码过的字符串重复编码（比如把
%20再变成%2520） - 如果参数值来自用户输入或 HTTP 请求体，务必先解码再存入 map，避免双重编码
curl_easy_escape 或手写编码函数选哪个？
libcurl 提供了 curl_easy_escape，但它返回的是 char*，需手动 free，且线程不安全（内部用静态缓冲区）。在现代 C++ 项目里，更推荐手写一个无状态、可复用的编码函数：
std::string url_encode(const std::string& s) {
std::string out;
for (char c : s) {
if (isalnum(c) || c == '-' || c == '_' || c == '.' || c == '~') {
out += c;
} else if (c == ' ') {
out += "%20";
} else {
char buf[4];
snprintf(buf, sizeof(buf), "%%%02X", (unsigned char)c);
out += buf;
}
}
return out;
}
这个版本明确、无副作用、支持 UTF-8 字节流（只要输入是合法 UTF-8 字符串即可）。别用 std::hex + std::stringstream——性能差、代码长，还容易因 locale 导致大写问题。
拼接时用 std::ostringstream 还是字符串拼接？
小参数量（+= 拼接最快；中等规模（几十对）用 std::ostringstream 更清晰；大量参数（上百对）建议预估总长，用 std::string 配合 reserve() 避免多次 realloc：
- 每对键值平均按 20 字节估算（含
=、&、编码膨胀），加 10% 余量 - 开头不加
?，由调用方决定是否作为完整 URL 使用（比如可能拼到已有 query 后面） - 第一对前面不加
&，后续每对前加&——用布尔标志比判断索引更可靠
示例片段：
std::string build_query(const std::unordered_map<:string std::string>& params) {
if (params.empty()) return "";
std::string out;
out.reserve(256); // 预分配，防抖动
bool first = true;
for (const auto& [k, v] : params) {
if (!first) out += "&";
first = false;
out += url_encode(k) + "=" + url_encode(v);
}
return out;
}
</:string>
中文、emoji、二进制数据传参怎么处理？
URL 只能传输字节序列，不是“字符串”。所以关键不是“怎么支持中文”，而是“怎么把原始字节正确编码成合法 URL 字节流”：
- UTF-8 编码的字符串可直接传入
url_encode，函数按字节处理，天然兼容 emoji（它们就是多字节 UTF-8 序列） - 若原始数据是二进制（如图片 base64 片段），先确保它本身不含控制字符，再整体编码；不要对 base64 结果再做 base64
- 浏览器地址栏显示中文是 UI 层解码结果，服务端收到的永远是百分号编码后的字节，必须用对应逻辑解码（如
curl_easy_unescape或反向实现）
最容易忽略的一点：不同系统对 URL 解码的容错性不同。比如某些老服务会把 + 当空格，但标准 RFC 3986 规定只有 %20 是空格，+ 是普通字符——除非你明确对接表单 enctype="application/x-www-form-urlencoded"，否则别用 + 替代空格。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
