怎么让 Qwen 解释看不懂的代码
「解释一下这段代码」产出深度随缘——官方把「清晰具体」列为发挥模型能力最重要的一步;解释代码要写死三样:读者水平、分层顺序、不确定标注,产出才对得上读者的理解台阶。
一、前提与适用
| 前提 | 说明 |
|---|---|
| 适用任务 | 读懂第三方库源码、接手他人代码、面试复盘陌生写法 |
| 官方依据 | Model Studio 提示词指南:构建清晰具体的提示词是发挥 LLM 能力最重要的一步,模糊与明确各有对照 |
| 解释三要素 | 读者水平(懂什么不懂什么)+分层顺序(整体→逐块)+不确定标注 |
| 不适用 | 需要运行验证的行为问题——先按 8.2 做最小复现,再谈解释 |
二、怎么做
解释三要素,逐项写死:
- 读者水平。写「刚学 Python,不了解装饰器」而不是「讲详细一点」——同一个函数,给初学者要展开闭包,给资深者一句带过。读者水平决定模型默认展开哪一层。
- 分层顺序。先整体功能(限定句数),再逐块(限定每块句数)——没有顺序约束,模型常把两者揉在一起,读者反而抓不住主线。
- 不确定标注。写「没有把握的行为标注『不确定』」——代码解释最常见的幻觉是给模糊行为编一个看似合理的理由,标注义务要显式下。
坏写法:
解释一下这段代码,尽量详细。
「详细」不可核对:不知道讲给谁听、不知道先讲什么、模糊行为会不会被编造全凭运气。
改写后的完整提示词:
你是代码讲解员。读者水平:刚学 Python,不了解装饰器。请按以下顺序解释下面的代码:
1. 先用两句话说明整体功能。
2. 再逐块解释,每块不超过 3 句。
不猜测代码的业务背景;没有把握的行为标注「不确定」。
代码:
def retry(times=3, delay=1):
def deco(fn):
def wrapper(*args, **kwargs):
for i in range(times):
try:
return fn(*args, **kwargs)
except Exception:
if i == times - 1:
raise
time.sleep(delay)
return wrapper
return deco
读者水平、分层句数、标注义务三样全部写死。
「提示词三要素是否齐」可以做成可跑检查:
## EXPECT: 读者水平=1 分层顺序=2 不确定标注=1
PROMPT = open("prompts/8.1.txt", encoding="utf-8").read()
level = int("读者水平" in PROMPT)
order = PROMPT.count("逐块") + PROMPT.count("整体功能")
hedge = int("不确定" in PROMPT)
print(f"读者水平={level} 分层顺序={order} 不确定标注={hedge}")
实测输出与判定:脚本实跑输出与首行注释一致。逐条判定:读者水平、不确定标注各命中 1 次,分层顺序(整体+逐块)命中 2 次,解释提示词形态完整。判定器只查形态;解释质量与幻觉控制,看下面的实测输出核。
怎么看这个示例:判定器是本地脚本,上面那条提示词另在 qwen3.7-max(temperature=0.7、top_p=0.8) 上实测;脚本输出不等于模型输出,两者分别核对。
模型回复(真实输出节选):
这段代码制作了一个叫“装饰器”的工具,用来给其他函数自动添加“失败后重试”的功能。如果目标函数运行报错,它会暂停一会儿再重新运行,直到达到你设置的最大尝试次数。
def retry(times=3, delay=1):
这定义了最外层的工具函数,接收两个参数:最大尝试次数 `times`(默认3次)和每次重试前的等待秒数 `delay`(默认1秒)。
def deco(fn):
这是中间层函数,它接收你要处理…(节选)

以上为模型真实回复的节选,实测日期 2026-11-16。
三、参数与边界
| 边界 | 说明 |
|---|---|
| 语言栈声明 | 跨语言代码先声明语言与版本,同名语法在不同栈行为不同 |
| 句数上限 | 分层句数是硬约束;初学者场景逐块 3 句常不够,可放宽到 5 句并逐块编号 |
| 幻觉残留 | 「不确定」标注降低但不根除编造,关键行为以实跑验证为准(8.2) |
| 代码完整性 | 贴出的代码缺 import 或上下文时先补全,缺片段的解释必然猜测 |
四、验收清单
| 检查项 | 通过标准 |
|---|---|
| 台阶对齐 | 解释从读者水平起步(如先讲闭包再讲装饰器),不跳层 |
| 分层清晰 | 整体与逐块界限分明,无混排 |
| 标注可查 | 模糊行为带「不确定」标注,无编造的确定说法 |
| 停手条件 | 连续两轮仍跳层或编造,先补全代码上下文而不是换问法 |
五、注意与相关
解释与调试是两件事:解释读「写得是什么」,调试查「为什么和预期不符」——行为类疑问先按 8.2 做最小复现实跑,不要让模型纯靠读代码下断言。清晰具体的总纲见 把模糊要求换成 Qwen 能核对的约束;代码生成侧的写法(带预期输出的脚本)见 让 Qwen 生成脚本与测试;评审侧重维度化的写法见 让 Qwen 评审重构与提交信息。