必须带注释示例，因deepseek将注释视为接口契约：//输入、//返回等约束直接决定参数类型、返回结构与异常处理，无示例则易生成写死连接、漏捕获异常等高危代码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用DeepSeek生成脚本时，加不加注释示例直接影响代码结构是否清晰、变量命名是否合理、边界处理是否完整——没给示例的提示词，模型常按自己理解“自由发挥”，比如把数据库连接写死在函数里，或漏掉异常捕获块。
为什么必须带注释示例
DeepSeek对“注释即契约”有强响应机制：它会把注释里的每一行当作待实现的接口约束。例如写“// 输入：用户ID（非空字符串）”，模型就不会接受None或数字类型；写“// 返回：成功返回字典，含code=0和data字段”，它就绝不会返回True/False或列表。
不带示例时，模型默认按通用模板填充，容易生成无上下文的孤立法、无校验的裸调用、无关闭逻辑的资源操作——这些在真实项目中都会引发运行时错误。
三类注释示例写法及效果对比
方法一：单行内联注释（适合简单函数）
在函数签名后紧跟//开头的说明，每行一个语义单元：
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
def parse_log_line(line: str) -> dict:<br> // 输入：原始日志字符串，格式为"[2024-01-01 10:23:45] INFO user_login success"<br> // 输出：解析后的字典，包含timestamp(str)、level(str)、event(str)<br> // 异常：输入为空字符串时抛出ValueError
这一步操作起来很简单，直接把三行注释贴在函数定义下方即可。模型会严格按这三条生成函数体，连docstring都自动补全。
方法二：块注释+伪代码混合（适合逻辑分支多的函数）
用"""包裹说明，并在关键位置插入缩进的伪代码：
def calculate_discount(total: float, coupon: str) -> float:<br> """<br> 根据订单总额与优惠券码计算最终折扣金额<br> 规则：<br> - 满100减10：coupon == "DISC10"<br> - 满200减30：coupon == "DISC30"<br> - 其他情况不打折<br> if total return 0<br> """
【注意：伪代码中的if语句必须顶格写，且不能用中文冒号】否则模型会误判为真实代码而跳过生成。
方法三：分段式接口注释（适合类或模块级生成）
先定义类骨架，再为每个方法单独加注释块，最后用// TODO: 根据以上注释实现完整类收尾：
class DataProcessor:<br> def __init__(self, source_path: str):<br> // 初始化：加载source_path指向的CSV文件到内存<br> // 要求：使用pandas.read_csv，设置encoding="utf-8"<br> def filter_by_date(self, start: str, end: str) -> pd.DataFrame:<br> // 过滤：保留date列在[start, end]闭区间内的行<br> // 要求：date列为datetime64类型，自动转换<br>// TODO: 根据以上注释实现完整类
这种写法会让DeepSeek生成带完整类型注解、符合PEP 8的类，且所有方法内部都包含参数校验和类型断言。
实操步骤：让注释示例真正起效
第一步：打开DeepSeek对话界面，确认已开启“深度思考”模式。
第二步：粘贴带注释示例的提示词，确保注释全部使用//或"""包裹，且无中文标点混用。
第三步：在提示词末尾追加硬性约束：要求：1) 所有函数必须包含完整类型注解 2) 每个异常路径必须有对应测试用例注释 3) 不得使用eval、exec等危险函数。
第四步：点击生成，等待输出完成。
第五步：将生成代码复制到编辑器，用mypy + pytest快速验证类型与逻辑——若报错，说明注释示例某处存在歧义，需回溯修改。
