人人都会AI编程

4.2.1 高质量代码生成的描述公式

更新时间:2026-06-29

提示词的质量直接决定 Cursor 生成代码的可用性。与其输入一句模糊的需求,不如套用一个简单公式,让 AI 一次性给出更接近生产环境的代码。

通用公式

「场景背景」+「具体任务」+「约束条件」+「输出要求」

| 组成部分 | 说明 | 示例 |
|---------|------|------|
| 场景背景 | 代码的运行环境、技术栈、角色定位 | "这是一个 Next.js 14 的 Server Action,连接 PostgreSQL" |
| 具体任务 | 动词+名词,明确输入输出 | "写一个带分页的用户搜索接口,支持按用户名模糊查询" |
| 约束条件 | 性能、安全、依赖、边界限制 | "不使用 ORM,手写 SQL 防注入;每页最多 100 条" |
| 输出要求 | 注释、类型、错误处理、额外交付物 | "返回 Zod 校验后的类型定义,并附带一段调用示例" |

对比示例

模糊的提问:

写一个用户登录功能。

按公式优化后:

我在写一个 Node.js + Express 的 REST 接口,请实现邮箱+密码登录。要求:1)密码使用 bcrypt 比对;2)登录成功后返回 JWT,有效期 2 小时;3)对错误邮箱和密码返回统一提示"账号或密码错误",不要暴露用户是否存在;4)给出完整的 TypeScript 类型定义和接口注释。

三个高频场景的简化模板

  1. 生成新函数/组件

> 用 [语言/框架] 实现 [功能],接收 [输入参数],返回 [输出结果]。要求 [约束 1]、[约束 2],并加上 [注释/单测/示例]。

  1. 重构现有代码

> 请重构下方代码,目标:[提升可读性/降低复杂度/优化性能]。约束:不引入新依赖,保持原有输入输出行为不变。

  1. 排查与修复 Bug

> 这段代码在 [具体场景] 时出现 [现象],预期应该是 [结果]。请定位根因并修复,用注释标出修改点。

实用提醒

  • 约束控制在 3–5 条:过多限制会让 AI 过度防御,生成大量冗余的 try-catch 或抽象层,反而降低可读性。
  • 代码与文字分离:把现有代码放在独立的代码块(```)中,在代码块外用 1、2、3 列出修改意图,比把指令混在代码注释里更清晰,AI 也更容易对齐上下文。