DeepSeek生成高质量Python注释需精准提示词：明确角色、限定格式、给出示例；分场景优化（补注释/中文注释/批量处理）；须指定docstring风格并禁止代码重构。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让DeepSeek为你生成高质量、可读性强、符合PEP 8规范的Python代码注释，关键在于提示词要精准引导模型理解上下文、注释粒度和风格偏好。
基础提示词结构
第一步：明确角色定位 → 第二步：限定输入输出格式 → 第三步：给出具体示例。
直接复制以下模板，替换【你的函数名】和【功能简述】即可使用：
你是一名资深Python工程师，专精于编写清晰、简洁、符合PEP 8规范的文档字符串和内联注释。请为以下Python函数添加完整注释：函数名为【你的函数名】，功能是【功能简述】。要求：① 使用Google风格docstring；② 每个参数、返回值、异常都需说明；③ 函数体内部关键逻辑行添加英文内联注释（# 开头）；④ 不修改原代码结构，只增补注释。
立即学习“Python免费学习笔记（深入）”；
针对不同场景的优化提示词
方法一：给已有代码补全注释（最常用）
把原始代码粘贴进来后，加上这句提示：
请在不改动任何代码逻辑和缩进的前提下，为下面这段Python代码补充完整注释。重点说明：【函数为何要校验输入类型而非仅用类型提示】，并在对应校验行后加#注释解释原因。
方法二：生成带中文注释的脚本（适合教学或团队协作）
你正在为新入职同事编写入门脚本。请为以下函数生成中文docstring和中文内联注释，语言平实易懂，避免术语堆砌。特别注意：对涉及time.sleep()、requests.get()等可能阻塞或失败的操作，必须标注超时与重试逻辑的意图。
方法三：批量处理多个函数（需结构化输出）
我将提供3个未注释函数。请按顺序为每个函数生成独立代码块，格式为：
[含完整注释的函数代码]。每个代码块上方用#===【函数名】===分隔。不要合并、不要省略空行、不要添加额外说明文字。
避坑要点与关键指令
① 避免模糊指令：“加点注释”“写得清楚些”——模型无法判断粒度，大概率只在函数开头写一句“# 处理数据”。
② 必须显式指定docstring风格：Google / NumPy / reStructuredText，否则DeepSeek默认用混合风格，参数对齐混乱。
③ 若函数含复杂算法，追加一句：“在第X行循环中，请用10字内短语说明该次迭代的核心目的，例如# 收集相邻节点ID”。
④ 【禁止让DeepSeek自行重构代码】——所有提示词必须包含“不修改原逻辑”“不调整缩进”“不增删变量”等强约束，否则它可能把if-else改写成三元表达式并删除原有注释位置。
