codecamp

怎么让 Qwen 解释看不懂的代码

「解释一下这段代码」产出深度随缘——官方把「清晰具体」列为发挥模型能力最重要的一步;解释代码要写死三样:读者水平、分层顺序、不确定标注,产出才对得上读者的理解台阶。

一、前提与适用

前提 说明
适用任务 读懂第三方库源码、接手他人代码、面试复盘陌生写法
官方依据 Model Studio 提示词指南:构建清晰具体的提示词是发挥 LLM 能力最重要的一步,模糊与明确各有对照
解释三要素 读者水平(懂什么不懂什么)+分层顺序(整体→逐块)+不确定标注
不适用 需要运行验证的行为问题——先按 8.2 做最小复现,再谈解释

二、怎么做

解释三要素,逐项写死:

  1. 读者水平。写「刚学 Python,不了解装饰器」而不是「讲详细一点」——同一个函数,给初学者要展开闭包,给资深者一句带过。读者水平决定模型默认展开哪一层。
  2. 分层顺序。先整体功能(限定句数),再逐块(限定每块句数)——没有顺序约束,模型常把两者揉在一起,读者反而抓不住主线。
  3. 不确定标注。写「没有把握的行为标注『不确定』」——代码解释最常见的幻觉是给模糊行为编一个看似合理的理由,标注义务要显式下。

坏写法:

解释一下这段代码,尽量详细。

「详细」不可核对:不知道讲给谁听、不知道先讲什么、模糊行为会不会被编造全凭运气。

改写后的完整提示词:

你是代码讲解员。读者水平:刚学 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):
这是中间层函数,它接收你要处理…(节选)

Qwen 输出卡片

以上为模型真实回复的节选,实测日期 2026-11-16。

三、参数与边界

边界 说明
语言栈声明 跨语言代码先声明语言与版本,同名语法在不同栈行为不同
句数上限 分层句数是硬约束;初学者场景逐块 3 句常不够,可放宽到 5 句并逐块编号
幻觉残留 「不确定」标注降低但不根除编造,关键行为以实跑验证为准(8.2)
代码完整性 贴出的代码缺 import 或上下文时先补全,缺片段的解释必然猜测

四、验收清单

检查项 通过标准
台阶对齐 解释从读者水平起步(如先讲闭包再讲装饰器),不跳层
分层清晰 整体与逐块界限分明,无混排
标注可查 模糊行为带「不确定」标注,无编造的确定说法
停手条件 连续两轮仍跳层或编造,先补全代码上下文而不是换问法

五、注意与相关

解释与调试是两件事:解释读「写得是什么」,调试查「为什么和预期不符」——行为类疑问先按 8.2 做最小复现实跑,不要让模型纯靠读代码下断言。清晰具体的总纲见 把模糊要求换成 Qwen 能核对的约束;代码生成侧的写法(带预期输出的脚本)见 让 Qwen 生成脚本与测试;评审侧重维度化的写法见 让 Qwen 评审重构与提交信息。

让 Qwen 生成脚本与测试
调试怎么给 Qwen 最小复现
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }