跳到主内容

LangChain Python

最后更新: 2026-10-11

1. 重复

for 循环适合遍历一组已有的数据,或者重复执行一个已知次数的操作。但有些任务无法提前知道要执行多少次:等待用户输入正确内容、不断读取消息直到收到结束标记、重试一个可能暂时失败的操作。

这类任务更适合使用 while 循环。它会在每次执行前检查一个条件,只要条件成立,就继续执行循环体:

countdown.py
1
count = 3
2
3
while count > 0:
4
print(count)
5
count -= 1
6
7
print("开始")

这段代码会打印 3、2、1,然后打印「开始」。在这个例子中,我们可以从初始值看出循环会执行三次;while 的执行方式仍然是每轮检查 count > 0,条件成立才继续。使用 while 不意味着循环次数一定无法预先判断。

2. while

while 的基本结构是:

syntax.py
1
while condition:
2
print("条件成立时执行")

执行顺序可以分成三步:

  1. 检查 condition 是否为真;
  2. 如果为真,执行缩进的循环体;
  3. 循环体执行结束后,回到第 1 步重新检查。

只要条件一直为真,循环就会一直执行。因此,循环体通常需要修改条件依赖的变量:

counter.py
1
number = 1
2
3
while number <= 5:
4
print(number)
5
number += 1

number += 1 让 number 最终超过 5,条件变成假,循环才能结束。如果忘记更新 number,程序就会一直打印 1,这种情况叫作无限循环。

while 同样使用缩进表示循环体,冒号不能省略。循环结束之后,程序会继续执行后面的代码:

after-loop.py
1
number = 3
2
3
while number > 0:
4
number -= 1
5
6
print("循环结束")

3. 条件

while 的条件可以是比较表达式,也可以是布尔变量:

ready.py
01
is_ready = False
02
checks = 0
03
04
while not is_ready and checks < 3:
05
print("正在检查")
06
checks += 1
07
08
if checks == 3:
09
is_ready = True
10
11
print("检查完成")

这里用 checks < 3 限制最多检查三次,即使 is_ready 一直没有变成真,循环也能正常结束。为循环设置明确的上限,是避免程序长时间运行的重要习惯。

有时循环会一直等待某个特殊值,这个值通常叫作「结束标记」或「哨兵值」。下面的 input() 示例用于本机终端,由用户逐次输入;浏览器在线案例会通过请求体提供输入序列:

sentinel.py
1
message = ""
2
3
while message != "quit":
4
message = input("请输入内容,输入 quit 结束:")
5
print(f"收到:{message}")

当用户输入 quit 时,条件 message != "quit" 变成假,循环自然结束。结束标记应该选择不会与正常数据混淆的值,并在文档或提示中明确告诉使用者。

如果条件本身来自函数调用或集合,也要确认它的真值变化符合预期。例如,下面的循环会不断从列表末尾取出任务,直到列表变空:

tasks.py
1
tasks = ["读取文件", "整理数据", "保存结果"]
2
3
while tasks:
4
task = tasks.pop()
5
print(f"正在处理:{task}")

空列表在条件中会被当作假,因此列表为空时循环结束。这里的 pop() 从末尾取元素,处理顺序是「保存结果、整理数据、读取文件」,用于展示后加入的元素先取出。如果业务需要按加入顺序处理任务,应使用相应的队列操作。

4. 控制

break 可以在循环体内部提前结束整个 while 循环。它特别适合处理「满足某个条件后立即停止」的情况:

find.py
1
number = 1
2
3
while number <= 10:
4
if number * number > 30:
5
break
6
7
print(number)
8
number += 1

当 number * number > 30 时,break 会立即跳出循环,循环后面的 number += 1 也不会执行。

continue 会跳过当前这一次循环,直接回到条件检查的位置:

skip.py
1
number = 0
2
3
while number < 5:
4
number += 1
5
6
if number == 3:
7
continue
8
9
print(number)

这段代码会跳过 3,但仍然打印 1、2、4、5。使用 continue 时,要确保在它之前已经更新了循环条件依赖的变量,否则可能因为一直跳过更新而造成无限循环。

在本机终端中,还可以使用 while True 表示「先进入循环,再由内部条件决定什么时候结束」:

stop-inside.py
1
while True:
2
command = input("请输入命令:")
3
4
if command == "quit":
5
break
6
7
print(f"执行命令:{command}")

while True 本身不会自动结束,所以必须保证某条路径能够执行 break。如果循环退出条件很明确,直接写在 while 后面通常更容易阅读。

5. 输入

while 经常用于要求用户重复输入,直到输入满足要求。下面的独立脚本需要在本机终端运行,会一直要求输入正数;不要把等待 input() 的代码放进 FastAPI 服务的启动路径:

positive.py
1
number = int(input("请输入一个正数:"))
2
3
while number <= 0:
4
number = int(input("输入无效,请重新输入:"))
5
6
print(f"你输入的正数是:{number}")

这个例子假设用户输入的内容一定能转换成整数。如果用户输入字母,int() 会抛出 ValueError,程序会直接结束。更完整的输入校验需要使用异常处理:

safe-input.py
01
number = None
02
03
while number is None or number <= 0:
04
value = input("请输入一个正数:")
05
06
try:
07
parsed = int(value)
08
except ValueError:
09
print("请输入整数")
10
continue
11
12
if parsed <= 0:
13
print("数字必须大于 0")
14
continue
15
16
number = parsed
17
18
print(f"你输入的正数是:{number}")

这里用 number is None 表示还没有得到有效结果,用 continue 处理无效输入。只有把合法数字赋给 number 后,循环条件才会变成假。

6. 实例

下面在本机终端实现一个最多尝试三次的密码校验。密码正确时立即结束,三次都失败时也会结束:

password.py
01
correct_password = "python"
02
attempts = 0
03
is_verified = False
04
05
while attempts < 3:
06
password = input("请输入密码:")
07
attempts += 1
08
09
if password == correct_password:
10
is_verified = True
11
break
12
13
print("密码不正确")
14
15
if is_verified:
16
print("验证成功")
17
else:
18
print("尝试次数已用完")

这个例子同时使用了循环条件和 break:attempts < 3 负责限制最大次数,密码正确时的 break 负责提前结束。把这两个结束原因分别写清楚,比用一个复杂条件更容易维护。

在真实的 FastAPI 或 LangChain 服务中,重试网络请求也可以使用类似思路,但通常还要加入等待时间、异常类型判断和最大重试次数,不能让服务无限重试:

retry.py
01
max_retries = 3
02
attempt = 0
03
04
while attempt < max_retries:
05
attempt += 1
06
print(f"第 {attempt} 次尝试")
07
08
request_succeeded = attempt == 3
09
if request_succeeded:
10
print("请求成功")
11
break
12
else:
13
print("请求失败,请稍后再试")

这里的 else 与 while 配套,只有循环没有通过 break 提前结束时才会执行。初学阶段可以先掌握 while 和 break,理解循环的结束方式后再使用这种写法。

7. 在线实验

文章中的 input() 例子可以在本机终端逐次输入。在线案例通过请求体提供一组输入字符串,再用真实的 while 循环依次读取、转换和判断,遇到第一个正数后停止。输入序列随请求一次性提供,循环本身不会等待终端输入。

目录结构
使用上下方向键浏览目录,左右方向键展开或收起,Enter 或空格切换展开状态。
    • main.py请求声明与实验入口
    • while_loops.py本篇 Python 实验
    • pyproject.toml基础依赖与项目配置
    • .python-version本机 Python 版本
    • .gitignore忽略环境与生成文件
    • README.md操作步骤与结果说明

main.py 提供接口,把请求数据交给主题文件。完整入口代码如下:

main.py
01
from typing import Annotated
02
03
from fastapi import FastAPI
04
from pydantic import BaseModel, Field
05
06
from while_loops import build_while_report
07
08
app = FastAPI()
09
10
class WhileRequest(BaseModel):
11
values: list[Annotated[str, Field(max_length=100)]] = Field(max_length=100)
12
max_attempts: int = Field(default=5, ge=1, le=100)
13
success_on_attempt: int = Field(default=3, ge=1, le=10)
14
15
@app.post("/while/validate")
16
async def validate_inputs(request: WhileRequest) -> dict[str, object]:
17
report = build_while_report(request.values, request.max_attempts, request.success_on_attempt)
18
validation = report["validation"]
19
print(f"校验次数:{validation['attempts']};结束原因:{validation['stop_reason']}")
20
for step in validation["steps"]:
21
print(f"第 {step['attempt']} 次:{step['value']},{step['status']}")
22
return report
23

实验保存在 while_loops.py 中。这里展示的代码与在线工作区的原始文件直接共用同一份来源:

while_loops.py
01
def build_while_report(values: list[str], max_attempts: int, success_on_attempt: int) -> dict[str, object]:
02
attempts = 0
03
number = None
04
steps = []
05
while number is None and attempts < len(values) and attempts < max_attempts:
06
value = values[attempts]
07
attempts += 1
08
try:
09
parsed = int(value)
10
except ValueError:
11
steps.append({"attempt": attempts, "value": value, "status": "请输入整数"})
12
continue
13
if parsed <= 0:
14
steps.append({"attempt": attempts, "value": value, "status": "数字必须大于 0"})
15
continue
16
number = parsed
17
steps.append({"attempt": attempts, "value": value, "status": "通过"})
18
break
19
20
if number is not None:
21
stop_reason = "已得到正数"
22
elif attempts >= max_attempts:
23
stop_reason = "已达到尝试上限"
24
else:
25
stop_reason = "输入已用完"
26
27
count = 3
28
countdown = []
29
while count > 0:
30
countdown.append(count)
31
count -= 1
32
33
tasks = ["读取文件", "整理数据", "保存结果"]
34
processed_tasks = []
35
while tasks:
36
processed_tasks.append(tasks.pop())
37
38
retry_attempt = 0
39
retry_steps = []
40
succeeded = False
41
exhausted = False
42
while retry_attempt < 3:
43
retry_attempt += 1
44
retry_steps.append(retry_attempt)
45
if retry_attempt == success_on_attempt:
46
succeeded = True
47
break
48
else:
49
exhausted = True
50
51
return {
52
"validation": {"number": number, "attempts": attempts, "steps": steps, "stop_reason": stop_reason},
53
"countdown": countdown,
54
"tasks_last_in_first_out": processed_tasks,
55
"retry": {"attempts": retry_steps, "succeeded": succeeded, "else_executed": exhausted},
56
}
57

7.1 运行并观察

打开在线案例,运行后发送默认 POST /while/validate,请求体是:

code.ts
1
{
2
"values": ["abc", "0", "-2", "5"],
3
"max_attempts": 5
4
}

第一次转换 "abc" 失败,循环通过 continue 进入下一轮;"0" 与 "-2" 虽然能转换成整数,但不满足正数要求;第四次得到 5 后执行 break。关键结果是:

code.ts
01
{
02
"validation": {
03
"number": 5,
04
"attempts": 4,
05
"stop_reason": "已得到正数"
06
},
07
"countdown": [3, 2, 1],
08
"tasks_last_in_first_out": ["保存结果", "整理数据", "读取文件"],
09
"retry": {"attempts": [1, 2, 3], "succeeded": true, "else_executed": false}
10
}

完整响应中的 validation.steps 会记录每次输入与判断结果,日志也会逐条打印。把 max_attempts 改为 2,即使列表里还有正数,循环也会在两次尝试后停止,number 为 null,结束原因是 "已达到尝试上限"。把 values 改成 [],循环体一次也不执行,返回 "输入已用完"。

请求体还可以增加 "success_on_attempt": 4。有限重试只允许执行三次,因此这时 retry.succeeded 为 false,retry.else_executed 为 true,能观察 while/else 在没有执行 break 时的行为。这一小段实验使用次数条件控制结果,没有发送网络请求。

主题文件中的列表、计数和结果每次请求都重新创建。所有循环都有退出条件;输入最多 100 项,每项最长 100 个字符,尝试上限在 1 到 100 之间,非法请求返回 HTTP 422。ValueError 已在循环内部处理,不会破坏整个请求。

7.2 本机运行

下载并解压项目,在项目目录执行:

code.ts
1
uv run fastapi dev main.py

然后打开 http://127.0.0.1:8000/docs,选择 POST /while/validate,填写上面的请求体并发送。

浏览器使用当前 Pyodide 的 Python 环境,本机使用 .python-version 指定的版本。在线模式无需启动本机端口,也不需要模型密钥。本篇的文件草稿、日志、Git 配置和 PI Agent 对话独立保存,依赖下载缓存可与同站其他文章共享。

正在验证登录状态
请稍候,验证完成后将继续显示文章内容

此段落已有评论,按 Enter 查看评论及回复列表。

评论-

文章反应
评论与回复

连接 GitHub 后查看和发表评论,也可在 GitHub 查看公开讨论。

添加评论
    即时渲染