Python urllib.parse.quote_plus 处理空格和加号有什么区别

在 Python 里处理查询参数时，quote_plus() 的关键不是“把字符转义一下”，而是遵循表单查询串的约定：输入中的空格编码为 +，原本就存在的加号编码为 %2B。因此，"C++ 教程" 应该得到 "C%2B%2B+%E6%95%99%E7%A8%8B"，解析后仍是原来的文本。

先把空格和加号拆成两种语义

查询参数常采用 application/x-www-form-urlencoded 规则。在这个语境里，+ 不是普通字符，而是“一个空格”的紧凑表示；所以编码器必须把输入中的字面加号保护起来，不能直接原样输出。

from urllib.parse import quote_plus

# 同时放入字面加号和空格，观察二者是否被区分
value = "C++ 教程"
encoded = quote_plus(value)
print(encoded)

# 输出：C%2B%2B+%E6%95%99%E7%A8%8B

这里前两个加号来自原文，变成了两个 %2B；中间的空格才变成单个 +。如果把结果交给 unquote_plus()，%2B 会还原为加号，+ 会还原为空格，编码和解码才能互相对应。

quote_plus 和 quote 适用的边界不同

quote_plus() 默认 safe=''，适合把一个值放入查询参数；斜杠也会被编码为 %2F。quote() 默认 safe='/'，更贴近路径片段，空格会编码为 %20。

不要只看“最终 URL 能不能打开”来选择函数：某些服务会宽松处理 %20 和 +，但签名、缓存键或精确查询时，编码差异就会变成不同的字节串。先确认下游是路径编码还是表单查询编码，再决定函数。

完整查询参数交给 urlencode

当参数不止一个时，直接拼接字符串很容易漏掉转义或把加号写成裸字符。urlencode() 默认使用 quote_plus() 为键和值编码，并用 & 连接参数。

from urllib.parse import parse_qs, urlencode

# 使用字典构造查询串，避免手写加号和百分号编码
params = {"q": "C++ 教程", "page": "2"}
query = urlencode(params)
print(query)

# 反向解析，检查字面加号和空格是否保持原义
decoded = parse_qs(query)
print(decoded["q"])

# 输出：q=C%2B%2B+%E6%95%99%E7%A8%8B&page=2
# 输出：['C++ 教程']

如果一个键对应多个值，可以传入二元组序列并设置 doseq=True，让同名参数分别出现；这比把列表转成一个自定义字符串更容易和服务端约定保持一致。若是 POST 表单数据，生成后的 ASCII 查询串还要按接口要求编码成字节再发送。

手写查询串时最容易踩的两个坑

第一，q=C+++教程 不是“C++ 加一个空格”的可靠写法。表单解析器通常会把三个连续加号都当成空格，字面加号已经丢失；正确做法是把字面加号写成 %2B，或者让 urlencode() 代劳。

第二，quote_plus(value, safe='+') 虽然能保留加号，但这只适用于下游明确把加号当普通字符、且不会按表单规则把它解码为空格的协议。对普通查询参数不要这样做。若需要路径编码，用 quote(value) 并按路径协议设置 safe。

• 值放在查询参数：优先 urlencode()；单值编码可用 quote_plus()。
• 值属于路径片段：优先 quote()，确认是否需要保留斜杠。
• 看到手写的 +：先问它是空格的编码，还是业务数据中的字面加号。
• 联调失败时同时记录编码前字符串、编码后查询串和解析后的值，不要只看浏览器地址栏。

常见问题

quote_plus 为什么把斜杠也编码了？

因为它默认面向查询值，默认没有保留 /；如果斜杠代表路径层级，应改用 quote() 或重新确认接口的字段语义。

URL 查询参数里的加号怎么写才不会变空格？

把字面加号编码为 %2B，最稳妥的方式是把原始值交给 urlencode() 或 quote_plus()，不要手写裸加号。