集合(set)用于保存一组不重复的元素。它适合表示标签、权限、已处理的任务和需要快速判断是否存在的数据。
使用花括号创建集合:
1topics = {"变量", "列表", "函数"} 2numbers = {1, 2, 3, 3} 3empty = set() 4 5print(topics) 6print(numbers) # {1, 2, 3} 7print(empty) # set()
重复元素只会保留一份。空集合不能写成 {},因为 {} 表示空字典,创建空集合必须使用 set()。
{}
set()
也可以使用 set() 把列表、字符串等可遍历对象转换成集合:
1numbers = set([1, 2, 2, 3, 3]) 2letters = set("Python") 3 4print(numbers) # {1, 2, 3} 5print(sorted(letters)) # ['P', 'h', 'n', 'o', 't', 'y']
集合中的元素必须是可哈希的,字符串、数字和只包含可哈希元素的元组可以作为元素;列表和字典不能直接放进集合:
1valid = {"Python", 1, ("FastAPI", "LangChain")} 2 3# invalid = {["Python", "FastAPI"]} # TypeError 4print(valid)
集合主要用于成员判断和集合关系,不应该依赖它的遍历顺序,也不能像列表一样使用索引和切片。
add() 向集合中加入一个元素。如果元素已经存在,集合不会产生重复项:
add()
1topics = {"变量", "列表"} 2 3topics.add("函数") 4topics.add("列表") 5 6print(topics) # {'变量', '列表', '函数'},顺序仅用于示意
update() 可以一次加入多个元素,它会遍历参数并逐个添加:
update()
1topics = {"变量"} 2topics.update(["列表", "字符串"]) 3 4print(topics)
删除元素时,remove() 在元素不存在时会抛出 KeyError,discard() 则不会报错:
remove()
KeyError
discard()
1topics = {"变量", "列表", "字符串"} 2 3topics.remove("列表") 4topics.discard("字典") 5 6print(topics)
pop() 会删除并返回一个元素,但集合没有固定顺序,因此不能预测它具体删除哪一个元素:
pop()
1topics = {"变量", "列表", "字符串"} 2removed = topics.pop() 3 4print(removed) 5print(topics)
需要删除全部元素时使用 clear():
clear()
1permissions = {"read", "write", "delete"} 2permissions.clear() 3 4print(permissions) # set()
集合运算可以直接表达两组数据之间的关系:
|
&
-
^
1python_topics = {"变量", "列表", "函数"} 2ai_topics = {"函数", "Agent", "LangChain"} 3 4print(python_topics | ai_topics) # 并集 5print(python_topics & ai_topics) # 交集 6print(python_topics - ai_topics) # 只属于 Python 集合 7print(python_topics ^ ai_topics) # 只属于一侧
这些运算也有对应的方法,例如 union()、intersection()、difference() 和 symmetric_difference():
union()
intersection()
difference()
symmetric_difference()
1frontend = {"HTML", "CSS", "JavaScript"} 2backend = {"Python", "JavaScript"} 3 4common = frontend.intersection(backend) 5only_frontend = frontend.difference(backend) 6 7print(sorted(common)) # ['JavaScript'] 8print(sorted(only_frontend)) # ['CSS', 'HTML']
集合运算会返回新的集合,不会修改参与运算的原集合。需要把结果写回原集合时,可以使用 |=、&= 或 -=:
|=
&=
-=
1permissions = {"read", "write"} 2permissions |= {"delete"} 3permissions -= {"write"} 4 5print(sorted(permissions)) # ['delete', 'read']
in 和 not in 是集合最常见的用法。集合专门为成员判断进行了优化,表达「是否已经存在」比遍历列表更直接:
in
not in
1processed_ids = {101, 102, 103} 2 3if 102 in processed_ids: 4 print("这个任务已经处理过") 5 6if 200 not in processed_ids: 7 print("可以处理新任务")
可以使用 issubset() 判断一个集合是否是另一个集合的子集,使用 issuperset() 判断是否包含另一个集合:
issubset()
issuperset()
1all_permissions = {"read", "write", "delete"} 2user_permissions = {"read", "write"} 3 4print(user_permissions.issubset(all_permissions)) # True 5print(all_permissions.issuperset(user_permissions)) # True 6print(user_permissions <= all_permissions) # True
isdisjoint() 用来判断两组数据是否没有共同元素:
isdisjoint()
1morning = {"早餐", "跑步"} 2evening = {"晚餐", "阅读"} 3 4print(morning.isdisjoint(evening)) # True
集合也可以直接放进 if 中。空集合是假值,非空集合是真值:
if
1pending = set() 2 3if not pending: 4 print("没有待处理任务")
可以使用 for 遍历集合,但不要依赖元素出现的顺序:
for
1tags = {"Python", "AI", "FastAPI"} 2 3for tag in tags: 4 print(tag)
如果需要稳定的展示顺序,先使用 sorted() 得到一个列表:
sorted()
1tags = {"Python", "AI", "FastAPI"} 2 3for tag in sorted(tags): 4 print(tag)
集合不能通过索引读取元素。如果业务同时需要「不重复」和「固定顺序」,可以使用字典的键,或者在去重时保留列表顺序:
1tags = ["Python", "AI", "Python", "Web", "AI"] 2unique_tags = list(dict.fromkeys(tags)) 3 4print(unique_tags) # ['Python', 'AI', 'Web']
这个写法利用了 Python 字典保留插入顺序的特性。如果只关心去重、不关心原顺序,直接使用 set(tags) 更简单。
set(tags)
权限判断是集合的常见场景。可以用子集关系判断用户是否拥有某项功能所需的全部权限:
1user_permissions = {"read", "write"} 2required_permissions = {"read", "write"} 3 4if required_permissions.issubset(user_permissions): 5 print("允许执行操作") 6else: 7 print("权限不足")
标签去重也可以直接使用集合:
1raw_tags = ["python", "ai", "python", "web", "ai"] 2tags = set(raw_tags) 3 4print(tags)
如果需要统计两个用户共同关注的主题,可以使用交集;如果需要找出只属于某个用户的主题,可以使用差集:
1alice = {"Python", "AI", "摄影"} 2bob = {"AI", "音乐", "摄影"} 3 4print("共同主题:", alice & bob) 5print("Alice 独有:", alice - bob)
如果集合本身也需要作为字典键,可以使用不可变集合 frozenset:
frozenset
1permission_groups = { 2 frozenset({"read"}): "访客", 3 frozenset({"read", "write"}): "编辑者", 4} 5 6print(permission_groups[frozenset({"read"})]) # 访客
frozenset 支持成员判断和集合运算,但不能使用 add()、remove() 等方法修改。它适合表示需要固定下来、还要作为字典键或其他集合元素的权限组合。
把两组主题和权限列表转换为真实 Python 集合,再返回运算结果。响应中需要展示的集合统一排序成列表,稳定显示顺序;Python 中的集合本身仍然没有位置顺序。
main.py 提供接口,sets_demo.py 执行实验。下面展示的代码与在线编辑器的初始文件来自同一份源码;修改编辑器中的文件后,保存并重新运行,接口就会使用修改后的内容。
01from typing import Annotated 02 03from fastapi import FastAPI 04from pydantic import BaseModel, Field 05 06from sets_demo import build_report 07 08app = FastAPI() 09Tag = Annotated[str, Field(max_length=100)] 10 11class SetRequest(BaseModel): 12 left: list[Tag] = Field(default_factory=list, max_length=100) 13 right: list[Tag] = Field(default_factory=list, max_length=100) 14 permissions: list[Tag] = Field(default_factory=list, max_length=100) 15 required: list[Tag] = Field(default_factory=list, max_length=100) 16 17@app.post("/sets") 18async def sets(request: SetRequest) -> dict[str, object]: 19 report = build_report(request.left, request.right, request.permissions, request.required) 20 print(f"共同主题:{report['operations']['intersection']}") 21 print(f"是否具备全部权限:{report['permissions']['allowed']}") 22 print(f"缺少权限:{report['permissions']['missing']}") 23 return report 24
01def build_report( 02 left_items: list[str], right_items: list[str], permissions: list[str], required: list[str] 03) -> dict[str, object]: 04 left = set(left_items) 05 right = set(right_items) 06 user_permissions = set(permissions) 07 required_permissions = set(required) 08 09 changed = left.copy() 10 changed.add("函数") 11 changed.update(right) 12 after_update = sorted(changed) 13 changed.remove("函数") 14 changed.discard("未出现的主题") 15 after_remove = sorted(changed) 16 removed = changed.pop() if changed else None 17 remaining_after_pop = sorted(changed) 18 changed.clear() 19 20 # frozenset 键只在 Python 内部查找,JSON 返回角色文本。 21 permission_groups = {frozenset({"read"}): "访客", 22 frozenset({"read", "write"}): "编辑者"} 23 frozen_permissions = frozenset(user_permissions) 24 return { 25 "python_type": type(left).__name__, 26 "unique": {"sorted": sorted(left), "input_count": len(left_items), "count": len(left)}, 27 "ordered_unique": list(dict.fromkeys(left_items)), 28 "operations": { 29 "union": sorted(left | right), 30 "intersection": sorted(left & right), 31 "left_difference": sorted(left - right), 32 "symmetric_difference": sorted(left ^ right), 33 "disjoint": left.isdisjoint(right), 34 }, 35 "mutation": {"after_update": after_update, "after_remove": after_remove, 36 "popped": removed, "after_pop": remaining_after_pop, 37 "after_clear": sorted(changed)}, 38 "permissions": { 39 "allowed": required_permissions.issubset(user_permissions), 40 "missing": sorted(required_permissions - user_permissions), 41 "required": sorted(required_permissions), 42 "owned": sorted(user_permissions), 43 }, 44 "frozen": {"type": type(frozen_permissions).__name__, 45 "role": permission_groups.get(frozen_permissions, "自定义权限")}, 46 } 47 48if __name__ == "__main__": 49 import json 50 51 print(json.dumps(build_report(["Python", "AI", "Python"], ["AI", "FastAPI"], 52 ["read"], ["read", "write"]), ensure_ascii=False, indent=2)) 53
打开本篇在线案例,点击运行并等待环境就绪。案例预览默认选择 POST,地址为:
1/sets
请求体已填好,可以直接发送:
01{ 02 "left": [ 03 "Python", 04 "AI", 05 "Python" 06 ], 07 "right": [ 08 "AI", 09 "FastAPI" 10 ], 11 "permissions": [ 12 "read" 13 ], 14 "required": [ 15 "read", 16 "write" 17 ] 18}
默认响应中,unique.count 为 2,intersection 是 ["AI"],left_difference 是 ["Python"]。permissions.allowed 为 false,missing 是 ["write"];frozen.type 为 frozenset,role 为 "访客"。
unique.count
2
intersection
["AI"]
left_difference
["Python"]
permissions.allowed
false
missing
["write"]
frozen.type
role
"访客"
日志会打印对应的关键操作结果。把 permissions 改成 ["read", "write"],allowed 会变成 true,missing 变成 [],role 为 "编辑者"。将 left 和 right 改成 [],可以观察空集合运算。修改 sets_demo.py 中 add() 的主题后,要同步修改对应 remove() 的主题,保存并重新运行。
permissions
["read", "write"]
allowed
true
[]
"编辑者"
left
right
sets_demo.py
接口限定元素为字符串,每组最多 100 项,避免列表或字典等不可哈希对象进入 set()。required 为空时,空集合是任何集合的子集,allowed 为 true。pop() 删除的是任意元素,不保证重复请求得到同一个 popped 值;其余展示结果明确 sorted()。frozenset 键只用于 Python 查询,返回给 JSON 的是角色文本。所有修改都在本次请求新建的集合上进行。
本案例只使用标准库、FastAPI 与 Pydantic,不需要模型密钥。下载并解压 ZIP,进入项目目录后执行:
1uv run python sets_demo.py 2uv run fastapi dev main.py
第一条直接在终端打印实验结果;第二条启动 FastAPI。打开 http://127.0.0.1:8000/docs,选择 POST /sets,填写同样的参数即可发起请求。本机使用 Python 3.12,浏览器使用当前 Pyodide 版本,通过 HTTPX ASGITransport 执行接口,不启动电脑上的 8000 端口。
本篇的代码、日志、Git 配置与 PI Agent 对话使用独立工作区;同站 Python 依赖缓存可以复用。本机配置文件、忽略规则和 README 都包含在项目中,可以在文件目录里查看、编辑和下载。
此段落已有评论,按 Enter 查看评论及回复列表。
连接 GitHub 后查看和发表评论,也可在 GitHub 查看公开讨论。
1. 创建
集合(set)用于保存一组不重复的元素。它适合表示标签、权限、已处理的任务和需要快速判断是否存在的数据。
使用花括号创建集合:
重复元素只会保留一份。空集合不能写成
{},因为{}表示空字典,创建空集合必须使用set()。也可以使用
set()把列表、字符串等可遍历对象转换成集合:集合中的元素必须是可哈希的,字符串、数字和只包含可哈希元素的元组可以作为元素;列表和字典不能直接放进集合:
集合主要用于成员判断和集合关系,不应该依赖它的遍历顺序,也不能像列表一样使用索引和切片。
2. 修改
add()向集合中加入一个元素。如果元素已经存在,集合不会产生重复项:update()可以一次加入多个元素,它会遍历参数并逐个添加:删除元素时,
remove()在元素不存在时会抛出KeyError,discard()则不会报错:pop()会删除并返回一个元素,但集合没有固定顺序,因此不能预测它具体删除哪一个元素:需要删除全部元素时使用
clear():3. 运算
集合运算可以直接表达两组数据之间的关系:
|&-^这些运算也有对应的方法,例如
union()、intersection()、difference()和symmetric_difference():集合运算会返回新的集合,不会修改参与运算的原集合。需要把结果写回原集合时,可以使用
|=、&=或-=:4. 判断
in和not in是集合最常见的用法。集合专门为成员判断进行了优化,表达「是否已经存在」比遍历列表更直接:可以使用
issubset()判断一个集合是否是另一个集合的子集,使用issuperset()判断是否包含另一个集合:isdisjoint()用来判断两组数据是否没有共同元素:集合也可以直接放进
if中。空集合是假值,非空集合是真值:5. 遍历
可以使用
for遍历集合,但不要依赖元素出现的顺序:如果需要稳定的展示顺序,先使用
sorted()得到一个列表:集合不能通过索引读取元素。如果业务同时需要「不重复」和「固定顺序」,可以使用字典的键,或者在去重时保留列表顺序:
这个写法利用了 Python 字典保留插入顺序的特性。如果只关心去重、不关心原顺序,直接使用
set(tags)更简单。6. 实例
权限判断是集合的常见场景。可以用子集关系判断用户是否拥有某项功能所需的全部权限:
标签去重也可以直接使用集合:
如果需要统计两个用户共同关注的主题,可以使用交集;如果需要找出只属于某个用户的主题,可以使用差集:
如果集合本身也需要作为字典键,可以使用不可变集合
frozenset:frozenset支持成员判断和集合运算,但不能使用add()、remove()等方法修改。它适合表示需要固定下来、还要作为字典键或其他集合元素的权限组合。7. 在线集合实验
把两组主题和权限列表转换为真实 Python 集合,再返回运算结果。响应中需要展示的集合统一排序成列表,稳定显示顺序;Python 中的集合本身仍然没有位置顺序。
7.1 完整案例代码
main.py 提供接口,sets_demo.py 执行实验。下面展示的代码与在线编辑器的初始文件来自同一份源码;修改编辑器中的文件后,保存并重新运行,接口就会使用修改后的内容。
7.2 运行与观察
打开本篇在线案例,点击运行并等待环境就绪。案例预览默认选择 POST,地址为:
请求体已填好,可以直接发送:
默认响应中,
unique.count为2,intersection是["AI"],left_difference是["Python"]。permissions.allowed为false,missing是["write"];frozen.type为frozenset,role为"访客"。日志会打印对应的关键操作结果。把
permissions改成["read", "write"],allowed会变成true,missing变成[],role为"编辑者"。将left和right改成[],可以观察空集合运算。修改sets_demo.py中add()的主题后,要同步修改对应remove()的主题,保存并重新运行。接口限定元素为字符串,每组最多 100 项,避免列表或字典等不可哈希对象进入 set()。required 为空时,空集合是任何集合的子集,allowed 为 true。pop() 删除的是任意元素,不保证重复请求得到同一个 popped 值;其余展示结果明确 sorted()。frozenset 键只用于 Python 查询,返回给 JSON 的是角色文本。所有修改都在本次请求新建的集合上进行。
7.3 在本机继续运行
本案例只使用标准库、FastAPI 与 Pydantic,不需要模型密钥。下载并解压 ZIP,进入项目目录后执行:
第一条直接在终端打印实验结果;第二条启动 FastAPI。打开 http://127.0.0.1:8000/docs,选择 POST /sets,填写同样的参数即可发起请求。本机使用 Python 3.12,浏览器使用当前 Pyodide 版本,通过 HTTPX ASGITransport 执行接口,不启动电脑上的 8000 端口。
本篇的代码、日志、Git 配置与 PI Agent 对话使用独立工作区;同站 Python 依赖缓存可以复用。本机配置文件、忽略规则和 README 都包含在项目中,可以在文件目录里查看、编辑和下载。