url编码是rfc 3986强制要求的百分号编码机制，仅大小写字母、数字及-._~共72个字符无需编码，其余字节（如空格→%20、utf-8中文→%e4%bd%a0%e5%a5%bd）必须转义为%xx形式。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
什么是URL编码，哪些字符必须被编码
URL编码（Percent Encoding）不是可选的美化操作，而是RFC 3986强制要求：所有不在unreserved字符集中的字节，都必须转义为%XX形式。这个集合只有大小写字母、数字和-._~共72个字符。空格必须变成%20，中文如你好（UTF-8下是E4 BD A0 E5 A5 BD）就得变成%E4%BD%A0%E5%A5%BD。别用std::isalnum简单判断——它不认~，也不处理多字节UTF-8；直接按字节检查更可靠。
C++中手写encode函数的关键细节
标准库不提供URL编码，得自己写。核心是逐字节检查+查表转换：
– 遍历输入字符串每个unsigned char（避免符号扩展）
– 对每个字节，查预定义的布尔数组should_encode[256]：true表示需编码
– 若需编码，用std::sprintf(buf, "%%%.2X", byte)写入（注意%%转义）
– 否则直接追加原字符
– 不要试图“先转UTF-8再编码”：输入字符串若已是UTF-8（如std::string），就直接按字节处理；若传入std::wstring，得先调用std::wstring_convert或C++11后用std::codecvt_utf8转码，但容易出错，建议接口统一收std::string并假设为UTF-8
bool should_encode[256] = {};
// 初始化：全设false，再把非unreserved设true
for (int i = 0; i
<h3>decode时如何安全处理%XX序列
解码比编码更容易出错：无效序列如<code>%GH</code>、<code>%2</code>、<code>%</code>结尾，必须拒绝而非静默忽略。
</h3><p>– 用<code>std::istringstream</code>或<code>std::stoi(s, nullptr, 16)</code>解析两位十六进制数，捕获异常或检查返回值<br>
– 遇到<code>%</code>但后续不足两位，或字符非法（如<code>G</code>），应停止并返回<code>std::nullopt</code>或抛异常<br>
– 不要盲目调用<code>std::tolower</code>：<code>%AB</code>和<code>%ab</code>都合法，但<code>%Ab</code>混合大小写也合法，直接用<code>std::isxdigit</code>判字符，再用<code>std::isdigit</code>/<code>std::isalpha</code>分别转数值<br>
– 解码结果仍是字节流，不自动转码：若原始是UTF-8编码的中文，解码后还是UTF-8字节，应用层需自行处理显示逻辑</p>
<h3>常见坑：空格、+号、路径分隔符的特殊处理
Web表单提交时，空格常被编码为<code>+</code>而非<code>%20</code>，这是application/x-www-form-urlencoded的约定，和通用URL编码不同。你的函数是否支持<code>+</code>→空格，取决于使用场景：
</h3><p>– 如果只处理URI path/query（如<code>https://ex.com/q?k=v</code>），严格按RFC，只认<code>%20</code>，忽略<code>+</code><br>
– 如果解析表单POST body，则必须额外处理<code>+</code>→<code>' '</code>，且仅在value部分（key里一般不用）<br>
– <code>/</code>、<code>?</code>、<code>=</code>等在URL中有语法意义，是否编码取决于上下文：path段里的<code>/</code>通常不编码（表示层级），但作为参数值出现时（如<code>file=/home/a.txt</code>）就必须编码为<code>%2F</code><br>
– 别用<code>std::replace</code>全局替换<code>+</code>：可能误伤URL里本意就是加号的内容（比如数学API：<code>/calc?expr=1%2B2</code>）</p>
实际项目中，最易被忽略的是编码粒度——你是在拼接整个URL前对每个参数单独encode，还是对整段字符串粗暴encode？前者正确，后者会把<code>?</code>、<code>=</code>也干掉，导致URL结构损坏。C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
