codebuddy不会自动添加注释，必须明确指令要求——在需求末尾添加“请为每段逻辑添加中文注释”等明确表述，或使用前置声明、格式锚定、示例引导三类结构化提示词，并生成后按四步法检查补全注释。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当你在CodeBuddy中输入需求却只得到光秃秃的代码，没有变量说明、逻辑分段或关键步骤解释时，必须主动触发注释生成机制——它不会默认开启，也不会根据你提问语气自动判断是否需要注释。

明确指令中加入注释要求

在向CodeBuddy描述需求时，直接在自然语言请求末尾添加“请为每段逻辑添加中文注释”或“在关键步骤旁加行内注释”。例如：“写一个Python函数计算斐波那契数列前n项→请为每段逻辑添加中文注释”。

这一步不能省略。CodeBuddy不解析语义隐含意图，【不写明‘注释’二字，它绝不会自动生成任何注释】。

使用结构化提示词模板

方法一：前置声明型
开头就写“输出要求：代码需包含三类注释——函数功能说明、参数含义说明、核心算法步骤说明”，再跟具体需求。

CodeBuddy Coding

调用 CodeBuddy CLI，支持代码生成、重构、调试、文件操作及任务进度监控，提供结构化结果输出。

下载

方法二：格式锚定型
在需求描述后空一行，单独一行写：“// 注释规范：函数头用三引号文档字符串，循环体内每3行代码至少1处#注释”。

方法三：示例引导型
先给一小段带注释的代码样例（如5行以内），再写“请按此风格为以下需求生成代码：……”。CodeBuddy会严格对齐该样式。

检查并修正生成结果中的注释缺失

第一步：生成后立即扫描所有函数定义上方是否有三引号或多行#注释。
第二步：定位for/while/if块，确认每个分支起始行下方是否有说明该分支作用的单行注释。
第三步：找到变量首次赋值处，检查右侧是否存在#说明该变量用途的短语。
第四步：若任一环节缺失，直接回复“请补全第X步的逻辑注释”，并引用缺失位置的上下文代码行。

这一步操作起来很简单，直接把缺失注释的代码行截图发回去就行。但要注意：如果原始请求里没提注释，它补的注释可能只覆盖主干逻辑，跳过边界条件处理部分。