for 循环适合遍历一组已有的数据,或者重复执行一个已知次数的操作。但有些任务无法提前知道要执行多少次:等待用户输入正确内容、不断读取消息直到收到结束标记、重试一个可能暂时失败的操作。
for
这类任务更适合使用 while 循环。它会在每次执行前检查一个条件,只要条件成立,就继续执行循环体:
while
1count = 3 2 3while count > 0: 4 print(count) 5 count -= 1 6 7print("开始")
这段代码会打印 3、2、1,然后打印「开始」。在这个例子中,我们可以从初始值看出循环会执行三次;while 的执行方式仍然是每轮检查 count > 0,条件成立才继续。使用 while 不意味着循环次数一定无法预先判断。
count > 0
while 的基本结构是:
1while condition: 2 print("条件成立时执行")
执行顺序可以分成三步:
condition
只要条件一直为真,循环就会一直执行。因此,循环体通常需要修改条件依赖的变量:
1number = 1 2 3while number <= 5: 4 print(number) 5 number += 1
number += 1 让 number 最终超过 5,条件变成假,循环才能结束。如果忘记更新 number,程序就会一直打印 1,这种情况叫作无限循环。
number += 1
number
while 同样使用缩进表示循环体,冒号不能省略。循环结束之后,程序会继续执行后面的代码:
1number = 3 2 3while number > 0: 4 number -= 1 5 6print("循环结束")
while 的条件可以是比较表达式,也可以是布尔变量:
01is_ready = False 02checks = 0 03 04while not is_ready and checks < 3: 05 print("正在检查") 06 checks += 1 07 08 if checks == 3: 09 is_ready = True 10 11print("检查完成")
这里用 checks < 3 限制最多检查三次,即使 is_ready 一直没有变成真,循环也能正常结束。为循环设置明确的上限,是避免程序长时间运行的重要习惯。
checks < 3
is_ready
有时循环会一直等待某个特殊值,这个值通常叫作「结束标记」或「哨兵值」。下面的 input() 示例用于本机终端,由用户逐次输入;浏览器在线案例会通过请求体提供输入序列:
input()
1message = "" 2 3while message != "quit": 4 message = input("请输入内容,输入 quit 结束:") 5 print(f"收到:{message}")
当用户输入 quit 时,条件 message != "quit" 变成假,循环自然结束。结束标记应该选择不会与正常数据混淆的值,并在文档或提示中明确告诉使用者。
quit
message != "quit"
如果条件本身来自函数调用或集合,也要确认它的真值变化符合预期。例如,下面的循环会不断从列表末尾取出任务,直到列表变空:
1tasks = ["读取文件", "整理数据", "保存结果"] 2 3while tasks: 4 task = tasks.pop() 5 print(f"正在处理:{task}")
空列表在条件中会被当作假,因此列表为空时循环结束。这里的 pop() 从末尾取元素,处理顺序是「保存结果、整理数据、读取文件」,用于展示后加入的元素先取出。如果业务需要按加入顺序处理任务,应使用相应的队列操作。
pop()
break 可以在循环体内部提前结束整个 while 循环。它特别适合处理「满足某个条件后立即停止」的情况:
break
1number = 1 2 3while number <= 10: 4 if number * number > 30: 5 break 6 7 print(number) 8 number += 1
当 number * number > 30 时,break 会立即跳出循环,循环后面的 number += 1 也不会执行。
number * number > 30
continue 会跳过当前这一次循环,直接回到条件检查的位置:
continue
1number = 0 2 3while number < 5: 4 number += 1 5 6 if number == 3: 7 continue 8 9 print(number)
这段代码会跳过 3,但仍然打印 1、2、4、5。使用 continue 时,要确保在它之前已经更新了循环条件依赖的变量,否则可能因为一直跳过更新而造成无限循环。
在本机终端中,还可以使用 while True 表示「先进入循环,再由内部条件决定什么时候结束」:
while True
1while True: 2 command = input("请输入命令:") 3 4 if command == "quit": 5 break 6 7 print(f"执行命令:{command}")
while True 本身不会自动结束,所以必须保证某条路径能够执行 break。如果循环退出条件很明确,直接写在 while 后面通常更容易阅读。
while 经常用于要求用户重复输入,直到输入满足要求。下面的独立脚本需要在本机终端运行,会一直要求输入正数;不要把等待 input() 的代码放进 FastAPI 服务的启动路径:
1number = int(input("请输入一个正数:")) 2 3while number <= 0: 4 number = int(input("输入无效,请重新输入:")) 5 6print(f"你输入的正数是:{number}")
这个例子假设用户输入的内容一定能转换成整数。如果用户输入字母,int() 会抛出 ValueError,程序会直接结束。更完整的输入校验需要使用异常处理:
int()
ValueError
01number = None 02 03while 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 18print(f"你输入的正数是:{number}")
这里用 number is None 表示还没有得到有效结果,用 continue 处理无效输入。只有把合法数字赋给 number 后,循环条件才会变成假。
number is None
下面在本机终端实现一个最多尝试三次的密码校验。密码正确时立即结束,三次都失败时也会结束:
01correct_password = "python" 02attempts = 0 03is_verified = False 04 05while attempts < 3: 06 password = input("请输入密码:") 07 attempts += 1 08 09 if password == correct_password: 10 is_verified = True 11 break 12 13 print("密码不正确") 14 15if is_verified: 16 print("验证成功") 17else: 18 print("尝试次数已用完")
这个例子同时使用了循环条件和 break:attempts < 3 负责限制最大次数,密码正确时的 break 负责提前结束。把这两个结束原因分别写清楚,比用一个复杂条件更容易维护。
attempts < 3
在真实的 FastAPI 或 LangChain 服务中,重试网络请求也可以使用类似思路,但通常还要加入等待时间、异常类型判断和最大重试次数,不能让服务无限重试:
01max_retries = 3 02attempt = 0 03 04while attempt < max_retries: 05 attempt += 1 06 print(f"第 {attempt} 次尝试") 07 08 request_succeeded = attempt == 3 09 if request_succeeded: 10 print("请求成功") 11 break 12else: 13 print("请求失败,请稍后再试")
这里的 else 与 while 配套,只有循环没有通过 break 提前结束时才会执行。初学阶段可以先掌握 while 和 break,理解循环的结束方式后再使用这种写法。
else
文章中的 input() 例子可以在本机终端逐次输入。在线案例通过请求体提供一组输入字符串,再用真实的 while 循环依次读取、转换和判断,遇到第一个正数后停止。输入序列随请求一次性提供,循环本身不会等待终端输入。
main.py 提供接口,把请求数据交给主题文件。完整入口代码如下:
main.py
01from typing import Annotated 02 03from fastapi import FastAPI 04from pydantic import BaseModel, Field 05 06from while_loops import build_while_report 07 08app = FastAPI() 09 10class 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") 16async 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
01def 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
打开在线案例,运行后发送默认 POST /while/validate,请求体是:
POST /while/validate
1{ 2 "values": ["abc", "0", "-2", "5"], 3 "max_attempts": 5 4}
第一次转换 "abc" 失败,循环通过 continue 进入下一轮;"0" 与 "-2" 虽然能转换成整数,但不满足正数要求;第四次得到 5 后执行 break。关键结果是:
"abc"
"0"
"-2"
5
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 改成 [],循环体一次也不执行,返回 "输入已用完"。
validation.steps
max_attempts
2
null
"已达到尝试上限"
values
[]
"输入已用完"
请求体还可以增加 "success_on_attempt": 4。有限重试只允许执行三次,因此这时 retry.succeeded 为 false,retry.else_executed 为 true,能观察 while/else 在没有执行 break 时的行为。这一小段实验使用次数条件控制结果,没有发送网络请求。
"success_on_attempt": 4
retry.succeeded
false
retry.else_executed
true
while/else
主题文件中的列表、计数和结果每次请求都重新创建。所有循环都有退出条件;输入最多 100 项,每项最长 100 个字符,尝试上限在 1 到 100 之间,非法请求返回 HTTP 422。ValueError 已在循环内部处理,不会破坏整个请求。
下载并解压项目,在项目目录执行:
1uv run fastapi dev main.py
然后打开 http://127.0.0.1:8000/docs,选择 POST /while/validate,填写上面的请求体并发送。
http://127.0.0.1:8000/docs
浏览器使用当前 Pyodide 的 Python 环境,本机使用 .python-version 指定的版本。在线模式无需启动本机端口,也不需要模型密钥。本篇的文件草稿、日志、Git 配置和 PI Agent 对话独立保存,依赖下载缓存可与同站其他文章共享。
.python-version
此段落已有评论,按 Enter 查看评论及回复列表。
连接 GitHub 后查看和发表评论,也可在 GitHub 查看公开讨论。
1. 重复
for循环适合遍历一组已有的数据,或者重复执行一个已知次数的操作。但有些任务无法提前知道要执行多少次:等待用户输入正确内容、不断读取消息直到收到结束标记、重试一个可能暂时失败的操作。这类任务更适合使用
while循环。它会在每次执行前检查一个条件,只要条件成立,就继续执行循环体:这段代码会打印 3、2、1,然后打印「开始」。在这个例子中,我们可以从初始值看出循环会执行三次;
while的执行方式仍然是每轮检查count > 0,条件成立才继续。使用while不意味着循环次数一定无法预先判断。2. while
while的基本结构是:执行顺序可以分成三步:
condition是否为真;只要条件一直为真,循环就会一直执行。因此,循环体通常需要修改条件依赖的变量:
number += 1让number最终超过 5,条件变成假,循环才能结束。如果忘记更新number,程序就会一直打印 1,这种情况叫作无限循环。while同样使用缩进表示循环体,冒号不能省略。循环结束之后,程序会继续执行后面的代码:3. 条件
while的条件可以是比较表达式,也可以是布尔变量:这里用
checks < 3限制最多检查三次,即使is_ready一直没有变成真,循环也能正常结束。为循环设置明确的上限,是避免程序长时间运行的重要习惯。有时循环会一直等待某个特殊值,这个值通常叫作「结束标记」或「哨兵值」。下面的
input()示例用于本机终端,由用户逐次输入;浏览器在线案例会通过请求体提供输入序列:当用户输入
quit时,条件message != "quit"变成假,循环自然结束。结束标记应该选择不会与正常数据混淆的值,并在文档或提示中明确告诉使用者。如果条件本身来自函数调用或集合,也要确认它的真值变化符合预期。例如,下面的循环会不断从列表末尾取出任务,直到列表变空:
空列表在条件中会被当作假,因此列表为空时循环结束。这里的
pop()从末尾取元素,处理顺序是「保存结果、整理数据、读取文件」,用于展示后加入的元素先取出。如果业务需要按加入顺序处理任务,应使用相应的队列操作。4. 控制
break可以在循环体内部提前结束整个while循环。它特别适合处理「满足某个条件后立即停止」的情况:当
number * number > 30时,break会立即跳出循环,循环后面的number += 1也不会执行。continue会跳过当前这一次循环,直接回到条件检查的位置:这段代码会跳过 3,但仍然打印 1、2、4、5。使用
continue时,要确保在它之前已经更新了循环条件依赖的变量,否则可能因为一直跳过更新而造成无限循环。在本机终端中,还可以使用
while True表示「先进入循环,再由内部条件决定什么时候结束」:while True本身不会自动结束,所以必须保证某条路径能够执行break。如果循环退出条件很明确,直接写在while后面通常更容易阅读。5. 输入
while经常用于要求用户重复输入,直到输入满足要求。下面的独立脚本需要在本机终端运行,会一直要求输入正数;不要把等待input()的代码放进 FastAPI 服务的启动路径:这个例子假设用户输入的内容一定能转换成整数。如果用户输入字母,
int()会抛出ValueError,程序会直接结束。更完整的输入校验需要使用异常处理:这里用
number is None表示还没有得到有效结果,用continue处理无效输入。只有把合法数字赋给number后,循环条件才会变成假。6. 实例
下面在本机终端实现一个最多尝试三次的密码校验。密码正确时立即结束,三次都失败时也会结束:
这个例子同时使用了循环条件和
break:attempts < 3负责限制最大次数,密码正确时的break负责提前结束。把这两个结束原因分别写清楚,比用一个复杂条件更容易维护。在真实的 FastAPI 或 LangChain 服务中,重试网络请求也可以使用类似思路,但通常还要加入等待时间、异常类型判断和最大重试次数,不能让服务无限重试:
这里的
else与while配套,只有循环没有通过break提前结束时才会执行。初学阶段可以先掌握while和break,理解循环的结束方式后再使用这种写法。7. 在线实验
文章中的
input()例子可以在本机终端逐次输入。在线案例通过请求体提供一组输入字符串,再用真实的while循环依次读取、转换和判断,遇到第一个正数后停止。输入序列随请求一次性提供,循环本身不会等待终端输入。main.py提供接口,把请求数据交给主题文件。完整入口代码如下:实验保存在
while_loops.py中。这里展示的代码与在线工作区的原始文件直接共用同一份来源:7.1 运行并观察
打开在线案例,运行后发送默认
POST /while/validate,请求体是:第一次转换
"abc"失败,循环通过continue进入下一轮;"0"与"-2"虽然能转换成整数,但不满足正数要求;第四次得到5后执行break。关键结果是:完整响应中的
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 本机运行
下载并解压项目,在项目目录执行:
然后打开
http://127.0.0.1:8000/docs,选择POST /while/validate,填写上面的请求体并发送。浏览器使用当前 Pyodide 的 Python 环境,本机使用
.python-version指定的版本。在线模式无需启动本机端口,也不需要模型密钥。本篇的文件草稿、日志、Git 配置和 PI Agent 对话独立保存,依赖下载缓存可与同站其他文章共享。