跳到主内容

LangChain Python

最后更新: 2026-10-11

1. 创建

集合(set)用于保存一组不重复的元素。它适合表示标签、权限、已处理的任务和需要快速判断是否存在的数据。

使用花括号创建集合:

create.py
1
topics = {"变量", "列表", "函数"}
2
numbers = {1, 2, 3, 3}
3
empty = set()
4
5
print(topics)
6
print(numbers) # {1, 2, 3}
7
print(empty) # set()

重复元素只会保留一份。空集合不能写成 {},因为 {} 表示空字典,创建空集合必须使用 set()。

也可以使用 set() 把列表、字符串等可遍历对象转换成集合:

convert.py
1
numbers = set([1, 2, 2, 3, 3])
2
letters = set("Python")
3
4
print(numbers) # {1, 2, 3}
5
print(sorted(letters)) # ['P', 'h', 'n', 'o', 't', 'y']

集合中的元素必须是可哈希的,字符串、数字和只包含可哈希元素的元组可以作为元素;列表和字典不能直接放进集合:

hashable.py
1
valid = {"Python", 1, ("FastAPI", "LangChain")}
2
3
# invalid = {["Python", "FastAPI"]} # TypeError
4
print(valid)

集合主要用于成员判断和集合关系,不应该依赖它的遍历顺序,也不能像列表一样使用索引和切片。

2. 修改

add() 向集合中加入一个元素。如果元素已经存在,集合不会产生重复项:

add.py
1
topics = {"变量", "列表"}
2
3
topics.add("函数")
4
topics.add("列表")
5
6
print(topics) # {'变量', '列表', '函数'},顺序仅用于示意

update() 可以一次加入多个元素,它会遍历参数并逐个添加:

update.py
1
topics = {"变量"}
2
topics.update(["列表", "字符串"])
3
4
print(topics)

删除元素时,remove() 在元素不存在时会抛出 KeyError,discard() 则不会报错:

remove.py
1
topics = {"变量", "列表", "字符串"}
2
3
topics.remove("列表")
4
topics.discard("字典")
5
6
print(topics)

pop() 会删除并返回一个元素,但集合没有固定顺序,因此不能预测它具体删除哪一个元素:

pop.py
1
topics = {"变量", "列表", "字符串"}
2
removed = topics.pop()
3
4
print(removed)
5
print(topics)

需要删除全部元素时使用 clear():

clear.py
1
permissions = {"read", "write", "delete"}
2
permissions.clear()
3
4
print(permissions) # set()

3. 运算

集合运算可以直接表达两组数据之间的关系:

运算符号含义
并集|两组中出现过的所有元素
交集&同时出现在两组中的元素
差集-出现在左侧、但不在右侧的元素
对称差集^只出现在其中一组的元素
operations.py
1
python_topics = {"变量", "列表", "函数"}
2
ai_topics = {"函数", "Agent", "LangChain"}
3
4
print(python_topics | ai_topics) # 并集
5
print(python_topics & ai_topics) # 交集
6
print(python_topics - ai_topics) # 只属于 Python 集合
7
print(python_topics ^ ai_topics) # 只属于一侧

这些运算也有对应的方法,例如 union()、intersection()、difference() 和 symmetric_difference():

methods.py
1
frontend = {"HTML", "CSS", "JavaScript"}
2
backend = {"Python", "JavaScript"}
3
4
common = frontend.intersection(backend)
5
only_frontend = frontend.difference(backend)
6
7
print(sorted(common)) # ['JavaScript']
8
print(sorted(only_frontend)) # ['CSS', 'HTML']

集合运算会返回新的集合,不会修改参与运算的原集合。需要把结果写回原集合时,可以使用 |=、&= 或 -=:

update-operation.py
1
permissions = {"read", "write"}
2
permissions |= {"delete"}
3
permissions -= {"write"}
4
5
print(sorted(permissions)) # ['delete', 'read']

4. 判断

in 和 not in 是集合最常见的用法。集合专门为成员判断进行了优化,表达「是否已经存在」比遍历列表更直接:

membership.py
1
processed_ids = {101, 102, 103}
2
3
if 102 in processed_ids:
4
print("这个任务已经处理过")
5
6
if 200 not in processed_ids:
7
print("可以处理新任务")

可以使用 issubset() 判断一个集合是否是另一个集合的子集,使用 issuperset() 判断是否包含另一个集合:

subset.py
1
all_permissions = {"read", "write", "delete"}
2
user_permissions = {"read", "write"}
3
4
print(user_permissions.issubset(all_permissions)) # True
5
print(all_permissions.issuperset(user_permissions)) # True
6
print(user_permissions <= all_permissions) # True

isdisjoint() 用来判断两组数据是否没有共同元素:

disjoint.py
1
morning = {"早餐", "跑步"}
2
evening = {"晚餐", "阅读"}
3
4
print(morning.isdisjoint(evening)) # True

集合也可以直接放进 if 中。空集合是假值,非空集合是真值:

truthy.py
1
pending = set()
2
3
if not pending:
4
print("没有待处理任务")

5. 遍历

可以使用 for 遍历集合,但不要依赖元素出现的顺序:

loop.py
1
tags = {"Python", "AI", "FastAPI"}
2
3
for tag in tags:
4
print(tag)

如果需要稳定的展示顺序,先使用 sorted() 得到一个列表:

sorted-loop.py
1
tags = {"Python", "AI", "FastAPI"}
2
3
for tag in sorted(tags):
4
print(tag)

集合不能通过索引读取元素。如果业务同时需要「不重复」和「固定顺序」,可以使用字典的键,或者在去重时保留列表顺序:

unique-order.py
1
tags = ["Python", "AI", "Python", "Web", "AI"]
2
unique_tags = list(dict.fromkeys(tags))
3
4
print(unique_tags) # ['Python', 'AI', 'Web']

这个写法利用了 Python 字典保留插入顺序的特性。如果只关心去重、不关心原顺序,直接使用 set(tags) 更简单。

6. 实例

权限判断是集合的常见场景。可以用子集关系判断用户是否拥有某项功能所需的全部权限:

permissions.py
1
user_permissions = {"read", "write"}
2
required_permissions = {"read", "write"}
3
4
if required_permissions.issubset(user_permissions):
5
print("允许执行操作")
6
else:
7
print("权限不足")

标签去重也可以直接使用集合:

tags.py
1
raw_tags = ["python", "ai", "python", "web", "ai"]
2
tags = set(raw_tags)
3
4
print(tags)

如果需要统计两个用户共同关注的主题,可以使用交集;如果需要找出只属于某个用户的主题,可以使用差集:

interests.py
1
alice = {"Python", "AI", "摄影"}
2
bob = {"AI", "音乐", "摄影"}
3
4
print("共同主题:", alice & bob)
5
print("Alice 独有:", alice - bob)

如果集合本身也需要作为字典键,可以使用不可变集合 frozenset:

frozen.py
1
permission_groups = {
2
frozenset({"read"}): "访客",
3
frozenset({"read", "write"}): "编辑者",
4
}
5
6
print(permission_groups[frozenset({"read"})]) # 访客

frozenset 支持成员判断和集合运算,但不能使用 add()、remove() 等方法修改。它适合表示需要固定下来、还要作为字典键或其他集合元素的权限组合。

7. 在线集合实验

把两组主题和权限列表转换为真实 Python 集合,再返回运算结果。响应中需要展示的集合统一排序成列表,稳定显示顺序;Python 中的集合本身仍然没有位置顺序。

案例项目文件
使用上下方向键浏览目录,左右方向键展开或收起,Enter 或空格切换展开状态。
    • main.pyFastAPI 接口与请求参数校验
    • sets_demo.py本篇主题的 Python 实验
    • pyproject.toml项目与基础依赖配置
    • .python-version本机 Python 3.12
    • .gitignore忽略环境与生成文件
    • README.md运行步骤与边界说明

7.1 完整案例代码

main.py 提供接口,sets_demo.py 执行实验。下面展示的代码与在线编辑器的初始文件来自同一份源码;修改编辑器中的文件后,保存并重新运行,接口就会使用修改后的内容。

main.py
01
from typing import Annotated
02
03
from fastapi import FastAPI
04
from pydantic import BaseModel, Field
05
06
from sets_demo import build_report
07
08
app = FastAPI()
09
Tag = Annotated[str, Field(max_length=100)]
10
11
class 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")
18
async 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
sets_demo.py
01
def 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
48
if __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

7.2 运行与观察

打开本篇在线案例,点击运行并等待环境就绪。案例预览默认选择 POST,地址为:

code.ts
1
/sets

请求体已填好,可以直接发送:

code.ts
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 为 "访客"。

日志会打印对应的关键操作结果。把 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,进入项目目录后执行:

code.ts
1
uv run python sets_demo.py
2
uv 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 查看公开讨论。

添加评论
    即时渲染