URL中文参数必须用urllib.parse.quote()或urlencode()编码为ASCII，因HTTP协议强制要求请求行和头部仅含ASCII字符；直接拼接中文会触发UnicodeEncodeError或导致400错误及乱码。
URL里的中文参数必须编码成ASCII字符，否则 urllib.parse 会直接报错或导致服务端解析失败——这不是可选项，是HTTP协议强制要求。
为什么直接拼接中文会导致错误？
HTTP请求行和头部只允许 ASCII 字符。像 "https://api.example.com?q=你好" 这种写法，在调用 urllib.request.urlopen() 时会触发 UnicodeEncodeError: 'ascii' codec can't encode characters；即使侥幸发出请求，多数后端（如 Flask、Django）也会返回 400 或乱码。
正确做法：用 urllib.parse.quote() 编码单个参数值
quote() 是处理中文参数最直接的函数，它默认使用 UTF-8 编码，并将非 ASCII 字符转为 %xx 形式：
from urllib.parse import quote <p>q = "测试数据" encoded_q = quote(q) # → "%E6%B5%8B%E8%AF%95%E6%95%B0%E6%8D%AE" url = f"<a href="https://www.php.cn/link/02d4016117549d136b3826efc811aca7">https://www.php.cn/link/02d4016117549d136b3826efc811aca7</a>}"
- 不要用
quote_plus()替代——它会把空格转成+，而现代 API 普遍要求空格也编码为%20 - 如果参数值本身含
/、?等 URL 特殊字符，且你希望它们也被编码，传入safe=''（即quote(q, safe='')） -
quote()默认编码路径组件；对查询参数，推荐显式指定encoding='utf-8'，避免环境 locale 干扰
批量构造查询字符串：用 urllib.parse.urlencode()
当有多个参数（尤其含中文）时，手动拼接易出错，应交由 urlencode() 处理：
立即学习“Python免费学习笔记（深入）”；
from urllib.parse import urlencode
<p>params = {
"q": "北京天气",
"page": 1,
"sort": "时间"
}
query_str = urlencode(params, encoding='utf-8') # → "q=%E5%8C%97%E4%BA%AC%E5%A4%A9%E6%B0%94&page=1&sort=%E6%97%B6%E9%97%B4"
url = f"<a href="https://www.php.cn/link/515e54370d38b4af21bf08cff544d25e">https://www.php.cn/link/515e54370d38b4af21bf08cff544d25e</a>}"- 必须传
encoding='utf-8'，否则在 Windows 控制台等 locale 非 UTF-8 环境下会编码失败 - 若参数值是 bytes 类型，
urlencode()会跳过编码——确保输入是 str - 不推荐用
quote()分别处理每个值再拼接，既冗余又容易漏掉=和&的 URL 安全性校验
解码时务必用 urllib.parse.unquote()
服务端收到的编码参数需要还原，但要注意：unquote() 默认按 UTF-8 解码，如果原始文本不是 UTF-8（极少见），需显式指定 encoding：
from urllib.parse import unquote <p>encoded = "%E5%8C%97%E4%BA%AC" decoded = unquote(encoded) # → "北京"
- 若解码后出现 符号，大概率是服务端用了错误编码（比如 GBK）生成了 URL，此时需先用
unquote(encoded).encode('latin1').decode('gbk')补救（不推荐，应推动上游修复） -
unquote_plus()会把+当空格还原，仅用于 legacy 场景，新项目一律用unquote()
真正麻烦的不是编码本身，而是混合使用 quote、urlencode 和手动拼接时，部分参数被编码、部分没被编码，最终 URL 半截乱码——这种问题很难一眼看出，调试时得逐段 print 原始值和编码后结果对比。
