当前位置：首页 > ops >正文

urllib.parse.urlencode 的使用详解

ops 2025/7/21 9:26:14

——让你轻松处理 URL 参数的利器

在编写 Python 网络程序时，我们经常需要和 Web 接口打交道。接口通常要求我们通过 URL 的 查询字符串（Query String） 传递参数，比如登录接口：

https://example.com/login?name=admin&password=123456&code=8V74

要将这样的参数组装成字符串手动拼接不仅麻烦还容易出错。幸好，Python 的 urllib.parse 模块为我们提供了非常方便的工具：urlencode()。

一、示例代码解析

我们先来看一段代码示例：

import urllib.parse dict = {"name": "admin", "password": "123456", "code": "8V74"} result = urllib.parse.urlencode(dict) print(result)

输出结果为：

name=admin&password=123456&code=8V74

这就是一个标准的 URL 查询字符串格式。

二、什么是 urlencode？

urllib.parse.urlencode() 是一个函数，作用是将字典对象编码为 URL 查询字符串格式，用于拼接到 GET 请求的 URL 后。

✅ 适用场景：

拼接 GET 请求参数
构造 Web 表单数据
与服务器交互前预处理参数

三、原理与语法说明

1. 函数定义：

urllib.parse.urlencode(query, doseq=False, safe='', encoding=None, errors=None, quote_via=quote_plus)

最常用的就是第一个参数 query，它可以是：

字典（dict）
元组列表（例如：[('name', 'admin'), ('code', '8V74')]）

2. 参数解释：

参数	含义
`query`	要编码的参数，通常是 dict 或 (key, value) 元组列表
`doseq`	如果值是列表，是否展开多个键值对
`encoding`	编码格式，默认 utf-8
`quote_via`	编码时使用的方式，默认 `quote_plus`（空格变 `+`）

四、进阶用法举例

1. 参数值含中文怎么办？

import urllib.parse params = {"name": "管理员", "city": "北京"} query_str = urllib.parse.urlencode(params) print(query_str)

输出：

name=%E7%AE%A1%E7%90%86%E5%91%98&city=%E5%8C%97%E4%BA%AC

✔ 编码后的字符串可以安全传输，不会出乱码！

2. 如果一个参数有多个值？

比如：tags=python&tags=crawler

params = {"tags": ["python", "crawler"]} query_str = urllib.parse.urlencode(params, doseq=True) print(query_str)

输出：

tags=python&tags=crawler

✔ 使用 doseq=True 自动展开多个同名键！

五、与 requests 联动使用

你可以将 urlencode() 与 requests 联用：

import requests import urllib.parse params = {"name": "admin", "password": "123456", "code": "8V74"} query_string = urllib.parse.urlencode(params) url = f"https://example.com/login?{query_string}" response = requests.get(url) print(response.status_code)

✔ 构造 GET 请求变得轻而易举！

六、总结

优点	说明
✅ 简洁	将字典快速转换为 URL 查询字符串
✅ 安全	自动进行 URL 编码（避免中文或特殊符号出错）
✅ 通用	可用于 GET 请求、网页参数拼接、接口调用等多种场景