pip install furl

from furl import furl
# 解析一个测试URL
url = "https://www.example.com:8080/search?q=python&lang=zh#intro"
url_obj = furl(url)  # 把URL变成可操作的对象
# 直接访问URL的各个部分
print("协议:", url_obj.scheme)    # 输出：https
print("主机名:", url_obj.host)    # 输出：www.example.com
print("端口:", url_obj.port)      # 输出：8080
print("查询参数:", dict(url_obj.args))  # 输出：{'q': 'python', 'lang': 'zh'}

运行后看到对应输出，就代表安装成功啦！

4个核心案例（新手直接抄，复制就能跑）

案例1：解析URL（比urllib简洁10倍）

新手常见写法（用urllib，步骤繁琐）：

from urllib.parse import urlparse, parse_qs
# 第一步：解析URL结构
url = "https://www.example.com:8080/search?q=python&lang=zh#intro"
parsed = urlparse(url)
# 第二步：解析查询参数，还要处理列表格式
query_params = parse_qs(parsed.query)
q_value = query_params["q"][0]  # 结果是列表，要取第一个元素
lang_value = query_params["lang"][0]
print("q参数:", q_value)
print("lang参数:", lang_value)

furl优雅写法（直接访问属性，一步到位）：

from furl import furl
url = "https://www.example.com:8080/search?q=python&lang=zh#intro"
url_obj = furl(url)
# 直接访问查询参数，像字典一样简单
print("q参数:", url_obj.args["q"])  # 输出：python
print("lang参数:", url_obj.args["lang"])  # 输出：zh
print("所有参数:", dict(url_obj.args))  # 转成字典，方便查看
print("锚点（#后面的内容）:", url_obj.fragment)  # 输出：intro

✅ 新手小贴士：furl自动把查询参数整理成类似字典的结构，不用处理列表，直接取值，比urllib省一半代码～

案例2：添加/修改/删除查询参数（不用手动拼字符串）

想给URL加page=2参数，删lang=zh参数？用furl像操作字典一样简单：

from furl import furl
url = "https://www.example.com/search?q=python&lang=zh"
url_obj = furl(url)
# 1. 添加新参数（page=2）
url_obj.args["page"] = 2
print("添加参数后:", url_obj.url)  # 输出：https://www.example.com/search?q=python&lang=zh&page=2
# 2. 修改已有参数（q=python → q=python教程）
url_obj.args["q"] = "python教程"
print("修改参数后:", url_obj.url)  # 输出：https://www.example.com/search?q=python教程&lang=zh&page=2
# 3. 删除参数（删除lang）
del url_obj.args["lang"]
print("删除参数后:", url_obj.url)  # 输出：https://www.example.com/search?q=python教程&page=2

✅ 新手小贴士：修改后直接用url_obj.url获取完整URL，不用手动拼接，还能自动处理特殊字符编码～

案例3：构造URL（链式调用，一步到位）

想构造一个API链接https://api.example.com/v2/users/profile?fields=id,name,email？不用逐段拼接：

from furl import furl
# 链式调用：从基础URL开始，逐步添加路径和参数
api_url = (
    furl("https://api.example.com")  # 基础URL
    / "v2" / "users" / "profile"    # 添加路径（用/拼接，自动处理斜杠）
)
# 添加查询参数
api_url.args["fields"] = "id,name,email"
# 添加锚点（#后面的内容）
api_url.fragment = "section-permissions"
print("构造的完整URL:", api_url.url)
# 输出：https://api.example.com/v2/users/profile?fields=id,name,email#section-permissions

✅ 新手小贴士：路径用/拼接，不用管开头和结尾的斜杠，furl自动处理，避免出现//或缺少/的问题～

案例4：自动处理特殊字符（中文、&、空格）

URL里有中文、空格、&这些特殊字符，手动编码容易出错，furl自动搞定：

from furl import furl
# 1. 含中文和空格的参数
url_obj = furl("https://example.com/search")
url_obj.args["keyword"] = "Python 高级编程 & 数据分析"  # 带空格和&
print("自动编码后URL:", url_obj.url)
# 输出：https://example.com/search?keyword=Python%20%E9%AB%98%E7%BA%A7%E7%BC%96%E7%A8%8B%20%26%20%E6%95%B0%E6%8D%AE%E5%88%86%E6%9E%90
# 2. 解码查看原始值
print("解码后的参数:", url_obj.args["keyword"])
# 输出：Python 高级编程 & 数据分析

✅ 新手小贴士：不管是中文、空格，还是&、=这些特殊符号，furl都能自动转成URL安全的编码格式，解析时又能还原，不用手动处理urllib.parse.quote～

新手常见问题&避坑指南

1. furl对象是不可变的吗？

默认不可变！修改参数（如url_obj.args["page"]=2）会返回新对象？不，实际修改时直接生效～ 若想保留原对象，用url_obj.copy()创建副本再修改：

from furl import furl
url1 = furl("https://example.com")
url2 = url1.copy()  # 复制副本
url2.args["page"] = 2
print(url1.url)  # 原对象不变：https://example.com
print(url2.url)  # 副本修改：https://example.com?page=2

2. 多个同名参数怎么处理？

比如?tag=python&tag=api，furl会自动保存为列表，取值时用url_obj.args.getlist("tag")：

from furl import furl
url = "https://example.com?tag=python&tag=api"
url_obj = furl(url)
print(url_obj.args.getlist("tag"))  # 输出：['python', 'api']

3. 适用于哪些场景？

优缺点坦诚说，新手不踩坑

优点：

缺点：

最后福利：新手必备资源

项目地址：https://github.com/gruns/furl
（里面有更多高级用法，新手可以按需查找）

furl最适合需要频繁处理URL的新手，不用再为字符串拼接、编码解码头疼，让URL操作变得简单又可靠～