高阶版后端接口Python脚本编写提示词

角色定义与任务定位
请以“资深后端架构师与Python开发专家”的身份，进行本次内容生成。你的核心目标是：为生成一个符合生产环境要求、结构清晰、功能完整且具备良好可维护性的Python后端接口脚本，提供一套可直接执行的、模块化的提示词方案。你的产出不是理论讲解，而是能直接驱动代码生成或指导开发实践的“施工蓝图”。

适用场景

快速原型开发：需要基于明确的功能需求，快速生成可运行的接口脚本雏形。
代码规范化生成：在团队协作中，需要生成符合特定编码规范（如PEP 8）和项目结构的接口代码。
功能模块实现：针对特定业务逻辑（如用户认证、数据查询、文件处理等）生成标准化的接口处理函数。
教学与示例：创建结构良好、注释清晰的示例代码，用于演示后端接口的最佳实践。


核心提示词
以下提示词组合可根据具体场景选择或组合使用，直接输入以生成对应代码：

生成一个基于Flask框架的RESTful API端点，实现用户信息的GET（查询列表）和POST（新增）操作，使用SQLAlchemy ORM连接MySQL数据库，包含请求数据验证（使用Pydantic或Flask-WTF）和基本的错误处理。
编写一个FastAPI异步接口，用于处理文件上传，支持图片格式验证、大小限制，并将文件元信息存储到PostgreSQL，返回文件的访问URL。包含依赖注入进行用户认证。
创建一个Django REST framework的视图集（ViewSet），包含对“产品”模型的完整CRUD操作，支持分页、过滤（按价格范围、类别）和权限控制（仅管理员可修改）。
实现一个Python脚本，使用requests库作为客户端调用第三方天气API，解析返回的JSON数据，并将结果格式化后写入本地SQLite数据库，包含超时重试机制和API密钥管理。


风格方向

代码结构：严格遵循单一职责原则，按功能分离路由、业务逻辑、数据模型和工具函数。采用工厂模式或依赖注入管理应用实例。
注释与文档：为每个函数和复杂逻辑块添加清晰的docstring（遵循Google或reStructuredText风格）。关键步骤需有行内注释。
命名规范：变量和函数名使用snake_case，类名使用CamelCase，常量使用UPPER_SNAKE_CASE，确保名称具有描述性。
错误处理：使用明确的异常类型（如ValueError, HTTPException），提供有意义的错误信息和适当的HTTP状态码，避免裸露的except。


构图建议（代码组织框架）

导入区块：标准库、第三方库、本地模块分块导入，顺序清晰。
配置与初始化：集中管理数据库连接、应用配置、密钥等。
数据模型定义：使用ORM类或Pydantic模型明确定义数据结构。
路由与视图函数：路由装饰器或声明集中，视图函数逻辑层次分明（参数解析 -> 验证 -> 业务处理 -> 响应封装）。
工具函数与中间件：将认证、日志、数据库会话管理等跨切面关注点模块化。
主程序入口：明确应用启动方式（如if __name__ == '__main__':）。


细节强化

输入验证：对请求参数、请求体进行严格类型、范围、格式验证，并返回具体的验证错误信息。
日志记录：集成logging模块，记录接口访问、错误、关键业务操作，便于调试和审计。
数据库操作：使用会话管理确保连接正确关闭，考虑事务处理，对复杂查询进行性能优化。
响应标准化：统一响应格式，如{“code”: 200, “msg”: “success”, “data”: {}}，便于前端处理。
安全性：对敏感信息进行脱敏，防范SQL注入、XSS等常见Web攻击，使用HTTPS。
异步支持：在I/O密集型操作（如网络请求、文件读写）中考虑使用async/await提升性能。


使用建议

将上述“核心提示词”直接复制到你的AI编程助手（如ChatGPT、Cursor、Claude）或代码生成工具中，作为主要输入指令。
在生成代码后，根据“风格方向”和“细节强化”要点进行代码审查和优化，替换占位符（如数据库连接字符串、API密钥）。
根据实际项目框架（Flask/FastAPI/Django）和数据库选型，调整核心提示词中的具体技术栈关键词。
对于复杂业务，可先使用提示词生成基础框架，再分模块（如“仅生成用户认证的中间件函数”）细化填充。
始终在安全环境中测试生成的代码，特别是涉及数据库操作和外部API调用的部分。