Python开发代码生成调试专业版提示词

角色定义与任务定位

本方案服务于Python开发专家与提示词架构师，核心任务是以“代码生成+调试驱动”为双重目标，构建一组结构清晰、可直接交付给大语言模型（LLM）的专业提示词。您在使用时应将自己定位为：
· 能依据需求精准产出函数、类、模块完整代码的指令设计者；
· 能预判常见错误、注入测试用例与调试策略的质量把关人；br/>· 能融合Python最佳实践（PEP8、类型注解、文档字符串）的风格塑造者。

适用场景

• 快速生成符合生产标准的Python脚本、库函数、CLI工具或API接口。
• 对已有代码进行深度调试：定位逻辑错误、异常处理缺失、性能瓶颈或类型不匹配。
• 辅助Code Review：要求模型输出代码同时附带优化建议与单元测试框架。
• 学习或教学场景：生成带详细注释的示例代码，并模拟调试过程以解释原理。

核心提示词

以下提示词可直接复制并填入具体需求，注意保持“生成—调试—优化”的完整流程指令结构。

• 基础生成模板
  请以一个资深Python工程师的身份，生成一个函数/类，功能是【描述功能】。要求：1）包含完整的类型注解与Google风格docstring；2）使用标准库或【指定库】；3）输入参数边界条件处理（空值、异常值）；4）输出格式为纯文本代码块。
• 调试增强模板
  下面是我写的Python代码【粘贴代码】。请扮演调试助手，依次完成：1）指出所有可能的运行时错误（如NameError、TypeError、KeyError）并给出修正代码；2）添加assert或try/except块覆盖主要异常路径；3）为每个函数补充一个最小可复现的测试用例（使用unittest或pytest风格）。
• 性能优化模板
  针对以下Python代码【粘贴代码】，请以算法优化专家的身份分析：1）当前时间复杂度与空间复杂度；2）使用【如列表推导式、map/filter、生成器、Cython提示】等技巧重构性能瓶颈部分；3）输出优化前后的代码对比，并附带一个简单的计时测试片段。
• 完整流程模板
  请按如下顺序生成一个【具体项目，例如“文件批量重命名工具”】的完整Python项目：1）项目结构树与模块职责说明；2）主函数代码（含argparse或click命令行接口）；3）核心逻辑代码（含日志、异常处理、进度反馈）；4）requirements.txt与setup.py文件；5）一个包含3个测试用例的pytest文件。所有代码必须通过Python 3.11+类型检查。

风格方向

• 专业严谨：代码风格符合PEP8，变量命名语义化，docstring描述行为而非实现细节。
• 透明可追踪：每个代码块前附带简短逻辑说明，调试输出包含行号、变量状态及堆栈模拟。
• 分层抽象：提示词中明确区分“生成层”“调试层”“测试层”，避免混杂请求。

构图建议

虽然此处是文本提示词，但在视觉化表达时可参考以下布局思路：

• 代码块层次：将提示词拆为“功能说明框→代码生成框→错误标记框→优化对比框”，用分隔线或标题区分。
• 流程图辅助：对于复杂逻辑，可在提示词中要求模型输出“伪代码流程图”或“函数调用关系树”（以ASCII字符或Mermaid格式）。
• 对比式展示：调试部分建议使用“原文（红色标注问题）→修正后（绿色标注改动）”的视觉隐喻，命令模型用注释标记差异。

细节强化

• 错误注入痕迹：在调试模板中，主动要求模型模拟“一次错误复现过程”——先写出含典型错误的代码版本，再逐步修正，更适合教学场景。
• 环境兼容声明：在生成模板末尾追加一句“请注明依赖的Python版本与操作系统兼容性（Windows/macOS/Linux）”。
• 边角案例覆盖：提示词内明确指定“请额外考虑空列表、超大输入、并发写入等极端情况”以提升鲁棒性。
• 日志与监控：要求代码中包含logging（设置不同级别INFO/DEBUG）、性能计时装饰器或cProfile入口。

使用建议

• 动态替换变量：将上述模板中的【描述功能】【粘贴代码】替换为实际需求，每次使用仅变更核心参数，保持结构不变以稳定输出质量。
• 迭代式调试：先使用“基础生成模板”获取初版，然后粘贴结果进入“调试增强模板”进行多轮修正，最后用“性能优化模板”收尾。
• 结合上下文：如果AI模型有上下文限制，可将“完整流程模板”拆分为2～3次对话，每次指定当前阶段（如“第一阶段：生成项目结构树与主入口”）。
• 检查类型标注：输出后建议用mypy或pyright快速验证，若发现类型不一致，可追加提示词：“请修正所有类型不匹配，并确保函数签名与调用一致”。