夜雨聆风如果说AI编程时代，有什么技能是程序员必须掌握的“敲门砖”，那一定是写Prompt。
毫不夸张地说，Prompt的质量，直接决定了AI的好用程度。
Prompt写得好，AI就是你的超级助手：写代码、找Bug、做重构，无所不能，能帮你节省80%的重复工作；Prompt写得烂，AI就是“人工智障”，写的代码Bug满天飞，反而要你花几倍时间返工，最后还得骂一句“AI真没用”。
我见过太多人用AI写代码，只会说“帮我写一个XXX功能”，结果AI生成的东西根本不能用，就吐槽AI垃圾。其实问题从来不在AI，而在你写的Prompt太敷衍。
同样是写一个支付回调功能，有的人写的Prompt，AI生成的代码直接就能上线；有的人写的Prompt，AI生成的代码连基本的幂等性都没有，一上线就出故障。
这就是Prompt的差距，也是AI时代程序员的核心竞争力之一。
在开始之前，先记住这个万能的代码生成公式：任务描述 + 技术栈 + 约束条件 + 代码风格 + 示例参考
举个反面例子，很多人写Prompt都是这样的：“帮我写一个用户登录接口”。
这就是典型的敷衍Prompt，AI根本不知道你用什么语言、什么框架，要不要JWT、验证码、限流，错误码怎么定义、日志怎么打……它只能瞎猜，猜不对，自然就成了“垃圾代码”。
用刚才的5要素公式改造一下，效果完全不同：
【任务描述】帮我写一个Spring Boot的用户登录接口，支持手机号+密码登录和微信小程序登录两种方式；
【技术栈】Java 17 + Spring Boot 3.0 + Spring Security + JWT + MySQL + MyBatis-Plus；
【约束条件】密码使用BCrypt加密，错误次数限制5次，超过锁定1小时；接口需做参数校验，手机号格式、密码长度（6-20位）需符合要求；同一个IP1分钟最多请求10次（接口限流）；登录成功返回用户基本信息+双token（access_token有效期2小时，refresh_token有效期7天）；异常返回统一错误码和信息；记录完整操作日志（成功、失败、锁定等）；
【代码风格】遵循阿里巴巴Java开发规范，分层清晰，注释完整，方法命名见名知意；
【示例参考】参考下方注册接口的代码风格和错误码定义。
不用多说，这两种写法，AI生成的代码质量天差地别。
记住一句话：你给AI的信息越详细，AI给你的结果越精准；你想得越清楚，AI做得越到位。
废话不多说，直接上20个黄金模板，每个模板都有明确的使用场景和实操内容，大家可以直接复制套用，覆盖80%以上的AI编程场景。
第一部分：代码生成类模板（8个）
这部分是日常开发用得最多的模板，掌握这8个，大部分代码生成需求都能轻松搞定，不用再瞎琢磨怎么写Prompt。
模板1：功能开发模板（从零实现完整功能）
适用场景：开发新功能、新模块、新接口（比如短信发送、用户注册、订单管理等）。
模板内容：
帮我用【技术栈】实现【功能描述】
【需求详情】1. 功能1（详细描述）；2. 功能2（详细描述）；3. 补充功能（按需添加）；
【技术要求】1. 具体技术栈及版本；2. 架构要求（分层、设计模式等）；3. 性能要求（响应时间、并发量等）；4. 安全要求（权限、加密等）；
【约束条件】1. 遵循XX开发规范；2. 包含完整单元测试；3. 注释详细；4. 异常处理完善；5. 日志完整；
【返回要求】1. 可运行完整代码；2. 代码结构说明；3. 使用说明；4. 注意事项。
实操示例：帮我用Spring Boot实现一个短信发送功能。需求详情：支持阿里云、腾讯云、华为云三种短信渠道（可配置切换）；支持短信模板管理；同一个手机号1分钟最多发送1次、1小时5次、1天10次；发送记录持久化到数据库；失败自动重试（最多3次，间隔递增）；提供统一发送接口，调用方无需关心底层渠道。技术要求：Java 17 + Spring Boot 3.0 + MySQL + MyBatis-Plus + Redis，用策略模式实现多渠道切换，接口响应时间≤500ms，短信验证码存Redis（有效期5分钟）。约束条件和返回要求参考模板填写即可。
模板2：工具类生成模板（通用工具类）
适用场景：生成日期工具、字符串工具、加密工具、身份证校验工具等各类通用工具类。
模板内容：
帮我写一个【工具类名称】工具类，用【编程语言】实现。
【功能需求】1. 功能1（详细说明）；2. 功能2（详细说明）；3. 补充功能（按需添加）；
【设计要求】1. 方法静态（无需实例化）；2. 方法原子性（一个方法只做一件事）；3. 参数合法性校验（处理null）；4. 异常处理友好；5. 命名规范（驼峰）；6. 完整注释；7. 单元测试覆盖所有场景；
【返回要求】1. 完整工具类代码；2. 单元测试代码；3. 使用示例。
模板3：算法实现模板（特定算法/数据结构）
适用场景：实现LRU缓存、排序算法、二叉树操作等各类算法、数据结构或复杂逻辑。
模板内容：
帮我实现【算法名称】算法，用【编程语言】。
【算法描述】详细说明算法功能、输入输出、复杂度要求；
【实现要求】1. 时间/空间复杂度要求；2. 边界情况处理（空输入、单元素等）；3. 代码清晰，关键步骤注释；4. 变量命名有意义；
【返回要求】1. 完整算法代码；2. 算法思路说明；3. 复杂度分析；4. 单元测试；5. 使用示例。
模板4：SQL编写模板（复杂查询/存储过程）
适用场景：编写复杂SQL查询、统计报表、存储过程、视图等（尤其适合千万级数据量场景）。
模板内容：
帮我写一个SQL查询，基于【表结构说明】。
【查询需求】详细描述查询内容、统计维度、排序/分页要求；
【表结构】列出相关表的字段名、类型、注释；
【查询要求】1. 性能要求（是否需走索引）；2. 分页/排序/分组要求；3. 边界情况处理（null、除零等）；4. SQL方言（MySQL/Oracle等）；
【返回要求】1. 完整SQL语句；2. 思路说明；3. 索引建议；4. 优化方案。
模板5：API接口文档生成模板
适用场景：根据Controller代码，自动生成RESTful API接口文档（适配Swagger、YApi等平台）。
模板内容：
根据下面的Controller代码，生成完整的API接口文档。
【代码】粘贴Controller代码；
【文档要求】包含接口名称、请求URL/方法、请求/响应参数（名称、类型、必填项、示例）、请求/响应示例、错误码列表、注意事项；
【文档格式】Markdown格式，结构清晰，可直接复制使用。
模板6：前端组件生成模板（Vue/React）
适用场景：生成前端UI组件、页面、业务逻辑（Vue3、React均可）。
模板内容：
帮我用【Vue3/React】写一个【组件名称】组件。
【功能需求】1. 功能1（详细描述）；2. 功能2（详细描述）；
【UI要求】1. 样式风格（Element Plus/Ant Design等）；2. 响应式要求；3. 交互效果（加载、提示等）；
【技术要求】1. 编程方式（Composition API等）；2. TypeScript支持；3. 代码规范；4. 完整注释；
【返回要求】1. 完整组件代码；2. 样式代码；3. 使用示例；4. 注意事项。
模板7：测试用例生成模板（单元测试）
适用场景：为现有代码生成单元测试用例（覆盖正常、异常、边界场景）。
模板内容：
根据下面的代码，生成完整的单元测试用例，用JUnit 5 + Mockito。
【代码】粘贴需测试的代码；
【测试要求】1. 覆盖率要求（行覆盖率≥90%，分支覆盖率100%）；2. 测试场景（正常、边界、异常、参数校验等）；3. 测试方法命名清晰、带注释；4. 用断言，复杂依赖用Mock；
【返回要求】1. 完整测试类代码；2. 覆盖率说明；3. 测试思路。
模板8：正则表达式生成模板
适用场景：生成邮箱、手机号、身份证号等各类复杂正则表达式（AI最擅长，人类最头疼的场景）。
模板内容：
帮我写一个正则表达式，用来匹配【匹配内容描述】。
【匹配规则】1. 规则1（详细说明）；2. 规则2（详细说明）；
【要求】1. 完整正则表达式；2. 逐部分解释；3. 匹配/不匹配示例（各至少5个）；4. 对应编程语言的使用示例。
第二部分：代码优化类模板（6个）
这部分模板用来优化现有代码，解决“祖传代码”“屎山代码”的痛点，提升代码质量、性能和可读性。
模板9：代码重构模板（优化烂代码）
适用场景：重构可读性差、重复代码多、嵌套过深的祖传代码，不改变原有业务逻辑。
模板内容：
帮我重构下面的代码，提升代码质量和可读性。
【代码】粘贴需重构的代码；
【重构需求】1. 提升可读性（命名规范）；2. 拆分长方法（≤50行）；3. 消除重复代码；4. 优化if/else嵌套；5. 补充注释；6. 优化异常处理；7. 补充参数校验；8. 不改变业务逻辑；
【重构原则】保持对外接口不变、遵循开发规范、小步重构；
【返回要求】1. 重构后代码；2. 重构说明（改了什么、为什么改）；3. 前后对比；4. 风险点。
模板10：Bug修复模板（定位+解决Bug）
适用场景：根据报错信息和代码，快速定位Bug，给出修复方案（避免盲目调试）。
模板内容：
帮我定位并修复下面代码中的Bug。
【问题描述】详细说明操作目的、实际结果、期望结果、问题出现条件（必现/偶现）；
【报错信息】粘贴完整错误栈；
【相关代码】粘贴报错代码、依赖代码、相关配置；
【排查方向】（可选）自己怀疑的问题方向；
【返回要求】1. Bug原因分析；2. 至少2种修复方案（对比优缺点）；3. 修复后代码；4. 测试建议；5. 预防措施。
模板11：性能优化模板（解决慢代码）
适用场景：优化慢SQL、慢接口、内存泄漏、并发瓶颈等性能问题。
模板内容：
帮我分析并优化下面代码的性能问题。
【性能问题描述】1. 具体操作（SQL/接口/循环）；2. 当前耗时vs期望耗时；3. 数据量/并发量；
【慢代码】粘贴慢代码、慢SQL、相关配置；
【返回要求】1. 性能瓶颈分析；2. 分步骤优化方案；3. 优化后代码；4. 性能对比；5. 进一步优化建议。
模板12：代码Review模板（AI帮你查错）
适用场景：提交代码前，让AI先做一遍代码审查，提前发现问题（减少线上Bug）。
模板内容：
帮我做一次代码Review，审查下面的代码。
【代码】粘贴需Review的代码；
【审查维度】功能正确性、边界处理、异常处理、安全问题、性能、代码规范、可读性、可维护性、并发安全、日志；
【返回要求】1. 问题列表（按严重程度排序）；2. 问题说明+修改建议；3. 修改后代码；4. 整体评价+打分。
模板13：代码解释模板（看懂复杂代码）
适用场景：看不懂祖传代码、复杂算法、框架源码，让AI用通俗的话讲明白。
模板内容：
帮我解释下面的代码，讲得越详细越好。
【代码】粘贴需理解的代码；
【我的基础】（可选）新手/中级/高级开发，对相关技术的了解程度；
【解释要求】1. 整体功能总结；2. 结构说明；3. 逐段解释；4. 关键技术点讲解；5. 写法优缺点；6. 边界情况；7. 流程图说明；
【返回要求】由浅入深、通俗易懂、多举例子、配合图示。
模板14：技术方案设计模板（架构设计/技术选型）
适用场景：做系统技术方案、架构设计、技术选型，让AI帮你出专业建议。
模板内容：
我要做一个【系统名称】，帮我设计技术方案。
【需求描述】1. 系统核心功能、用户群体；2. 规模（用户量、数据量、并发量）；3. 性能要求；4. 成本要求；
【已有技术栈】（可选）现有技术，希望尽量复用；
【返回要求】1. 整体架构设计；2. 技术选型建议；3. 数据库设计；4. 关键技术难点+解决方案；5. 部署架构；6. 演进路线；7. 成本估算；8. 风险评估。
第三部分：高级技巧类模板（6个）
掌握这6个进阶模板，能让你和AI的协作效率再上一个台阶，避免踩坑，生成更高质量的代码。
模板15：多轮对话优化模板（优化AI生成结果）
适用场景：第一次生成的代码不满意，通过多轮对话优化，避免AI重复返工。
模板内容：
刚才的代码整体不错，但有几个问题需要修改：
【优点】（先肯定AI的优点，给正反馈）；
【需要修改的地方】1. 问题1（具体描述+期望效果）；2. 问题2（具体描述+期望效果）；
【新增需求】（可选）1. 新增功能1（详细描述）；
【注意】已经写得好的地方不要改，只修改上述问题，不要重构整个代码。
关键点：先肯定再否定，修改意见要具体，明确告知“不修改的部分”，避免AI越改越乱。
模板16：代码风格统一模板（贴合团队规范）
适用场景：让AI生成的代码，符合自己团队的代码规范（避免格式混乱、风格不统一）。
模板内容：
以后你给我写代码，都要遵循下面的代码风格规范：
【命名规范】类名大驼峰、方法名小驼峰、常量全大写+下划线，见名知意，不用拼音/无意义缩写；
【代码格式】缩进4个空格、大括号不换行、运算符前后留空格、方法间空2行；
【注释规范】类/公共方法有JavaDoc注释，复杂逻辑有行内注释，不写无用注释；
【异常处理】捕获具体异常、打印完整栈日志、不吞异常；
【其他规范】方法≤50行、if嵌套≤3层、无魔法值、入口参数校验；
【代码示例】粘贴一段团队规范代码，让AI参考。
模板17：上下文注入模板（让AI理解你的项目）
适用场景：跨文件开发时，让AI了解项目整体结构、规范，避免生成“脱节”的代码。
模板内容：
这是我们项目的基础信息，后面写代码都要基于这个规范：
【项目技术栈】（完整列出项目技术栈及版本）；
【项目结构】（说明各层作用，如controller层负责接口、service层负责业务等）；
【基础规范】（统一返回结果、异常处理、分页、日志等规范）；
【公共类示例】粘贴关键公共类（如统一返回类、异常类）；
【代码示例】粘贴一段项目规范代码；
后面我让你写代码，按这个规范来，无需重复说明。
模板18：思维链模板（让AI先思考再写代码）
适用场景：复杂逻辑开发，让AI先梳理思路，再写代码（避免思路混乱、代码出错）。
模板内容：
帮我实现【功能描述】，但先不要写代码，先按下面步骤思考：
【思考步骤】1. 需求分析（核心、关键点、坑）；2. 方案设计（多种方案对比，推荐方案）；3. 接口设计（类、方法、入参出参）；4. 边界处理（null、并发、异常）；5. 风险评估；
把思考过程完整写出来，我确认没问题后，你再写代码。
核心优势：避免AI“边想边写”，先打草稿，思路错了可及时纠正，不用等写完再返工。
模板19：自我修正模板（让AI自查Bug）
适用场景：AI写完代码后，让它自己做Code Review，自动发现并修正Bug（减少你的工作量）。
模板内容：
代码写完了，现在你自己做一次Code Review，按以下维度检查：
1. 功能正确性（有无明显Bug）；2. 边界情况（null、非法参数等处理）；3. 异常处理（有无吞异常）；4. 性能问题（N+1查询、循环操作数据库等）；5. 并发安全（多线程问题）；6. 代码规范（符合之前约定）；
如果发现问题，指出来并修正，给出最终正确代码。
模板20：专家角色扮演模板（提升回答专业性）
适用场景：特定领域问题（如架构设计、性能优化），让AI扮演行业专家，给出更专业的建议。
模板内容：
从现在开始，你是一个有着15年经验的【Java后端/前端/架构/数据库】专家，精通【相关技术栈】，参与过千万级用户系统的开发和架构设计，有丰富的实战和踩坑经验。
我现在遇到的问题：【详细描述问题】；
请以专家身份给出建议，要求：1. 深入浅出（说清怎么做、为什么）；2. 多方案对比（优缺点+适用场景）；3. 结合实际工作（考虑限制和坑）；4. 可操作步骤；5. 明确风险点。
常用角色：15年Java后端架构师、10年前端全栈工程师、数据库性能优化专家、云原生专家等。
写Prompt的10个黄金原则（必看）
掌握这些原则，就算不用模板，你也能写出高质量的Prompt，让AI更懂你。
1. 越具体越好，不要笼统：避免“帮我写个接口”，要明确技术栈、约束条件等；
2. 给角色，给身份：让AI扮演专家，回答质量会大幅提升；
3. 给示例，给参考：给AI看一段规范代码，比说“写规范点”更管用；
4. 分步骤，不要一次说完：复杂需求拆成多步，先确认方案再写代码；
5. 给正向反馈，也给负向反馈：夸好的地方，具体指出不好的地方；
6. 要求解释，不要只看结果：让AI说明“为什么这么写”，既能理解，也能发现问题；
7. 多生成几次，对比选择：同一个需求生成3次，综合优缺点；
8. 复杂需求拆小块：不要让AI一次生成整个项目，逐个模块验证；
9. 明确“不要做什么”：比如“不要用Java 21新特性”“不要改现有代码”；
10. 自己把控最终质量：AI可能犯错，代码Review和测试不能少。
写Prompt最常见的8个错误（避坑）
很多人Prompt写不好，都是踩了这些坑，看看你有没有中枪：
1. 信息太少，全靠AI猜：只说“帮我写个管理系统”，不说明技术栈、功能；
2. 一次问太多，贪多嚼不烂：让AI从0到1写完整电商项目，超出AI处理范围；
3. 只说要什么，不说不要什么：没说明项目用Java 8，AI用了Java 21新特性；
4. 不确认就往下走，一错到底：AI理解错需求不纠正，继续往下写，越错越远；
5. 只会用一个模板，不会变通：所有场景用同一个模板，不根据需求调整；
6. 全是黑话缩写，AI看不懂：用公司内部缩写、行业黑话，AI无法理解；
7. Prompt太啰嗦，重点模糊：废话太多，核心需求被淹没；
8. 不保存Prompt，每次重写：好的Prompt可以反复用，不保存就是浪费时间。
