来源：https://github.com/datawhalechina/vibe-vibe

经过本节学习，你将掌握

• 识别五种最常见的提示词错误
• 理解每种错误「差在哪里」
• 学会对应的修正方法
• 获得一个可反复使用的自检清单

为什么要学「错误示范」

与其告诉你「什么是好的提示词」，不如先看看「什么是差的提示词」。

原因很简单：避免错误比追求完美更容易做到，效果也更立竿见影。

下面是初学者最常犯的五个错误，每个错误都配有真实案例和修正方法。

错误 1：一次说太多（信息过载）

问题场景

你想让 AI 帮你做一个待办清单应用，于是一股脑把所有想法都倒出来：

❌ 差提示词

帮我做一个待办清单应用，要有添加任务、删除任务、编辑任务、
标记完成、设置优先级、设置截止日期、分类标签、搜索功能、
数据统计、导出功能，还要有暗黑模式，最好能同步到云端，
支持多设备使用，界面要好看，用 React 写，要有动画效果。

问题分析

• AI 面对 15+ 个需求，无法判断优先级
• 容易顾此失彼，每个功能都做得不完整
• 你收到的代码会非常复杂，难以理解和修改
• 违背了第二章学的「减法思维」

✅ 修正方法：分步骤拆解

【第一步：先做核心功能】
帮我实现待办清单的添加任务功能。
要求：
- 输入框 + 添加按钮
- 按回车也能添加
- 添加后清空输入框
- 空内容不能添加

技术栈：React + TypeScript
先只做这一个功能，其他功能后面再加。

📌 一句话法则

一次只让 AI 做一件事。复杂任务拆成多轮对话。

错误 2：一次说太少（上下文缺失）

问题场景

你想让 AI 写一段代码，但只说了最简单的需求：

❌ 差提示词

写一个登录页面

问题分析

• AI 不知道用什么技术（HTML？React？Vue？）
• AI 不知道要什么样式（简约？炫酷？企业风？）
• AI 不知道有什么功能（只有登录？还要注册？忘记密码？）
• AI 不知道你的技术水平（给你复杂代码你看不懂）

结果：AI 只能给你一个「通用模板」，大概率不是你想要的。

✅ 修正方法：补充三层上下文

【项目背景】
我在做一个个人博客网站，需要一个简单的管理员登录页面。
技术栈：Next.js + Tailwind CSS
风格：简约干净，白色背景，居中卡片式布局

【功能需求】
- 只需要用户名和密码两个输入框
- 一个登录按钮
- 不需要注册、忘记密码等功能
- 输入框要有基本的校验提示（不能为空）

【关于我】
我是前端初学者，请给我完整可运行的代码，关键部分加注释。

📌 一句话法则

把 AI 当作刚入职的实习生：你不说清楚，它就只能猜。

错误 3：期待 AI 读心（不说清楚目标）

问题场景

你让 AI 帮你优化代码，但没说「优化」是什么意思：

❌ 差提示词

帮我优化一下这段代码：
[粘贴了一段代码]

问题分析

「优化」可以有很多种理解：

• 让代码跑得更快（性能优化）？
• 让代码更容易读（可读性优化）？
• 让代码更短（精简代码）？
• 让代码更安全（安全性优化）？
• 让代码更易维护（架构优化）？

AI 不知道你想要哪种「优化」，只能按自己的理解来。

✅ 修正方法：明确目标和验收标准

帮我优化这段代码的可读性：

[粘贴代码]

优化目标：
1. 让其他开发者能快速看懂这段代码在做什么
2. 变量命名更清晰
3. 添加必要的注释
4. 如果有重复逻辑，提取成函数

请保持功能不变，只改善代码结构。

📌 一句话法则

说清楚「什么算完成」。给 AI 一个可以对照检查的验收标准。

错误 4：忽视格式要求（让 AI 自由发挥）

问题场景

你让 AI 整理一些信息，但没说想要什么格式：

❌ 差提示词

帮我整理一下 React 常用的 Hooks

问题分析

AI 可能给你：

• 一大段文字描述
• 或者一个简单列表
• 或者过于详细的教程
• 或者只有名字没有解释

每次结果都不一样，可能都不是你想要的格式。

✅ 修正方法：指定输出格式

帮我整理 React 最常用的 5 个 Hooks。

输出格式：
| Hook 名称 | 一句话解释 | 使用场景 |
|----------|-----------|---------|

要求：
- 只列最常用的 5 个，不要太多
- 解释要通俗易懂，初学者能看懂
- 使用场景给出具体例子

📌 一句话法则

想要什么格式，就先画出格式的「样子」给 AI 看。

错误 5：不做约束（AI 容易「加戏」）

问题场景

你只要一个简单功能，但 AI 给了你一堆额外的东西：

❌ 差提示词

帮我写一个显示当前时间的组件

AI 可能的「加戏」

• 加上了时区选择功能
• 加上了 12/24 小时切换
• 加上了自定义格式功能
• 加上了暗黑模式适配
• 用了你没听说过的第三方库

你只想要一个简单的时钟，却收到了一个「全功能时间管理器」。

✅ 修正方法：用「不做清单」约束范围

帮我写一个显示当前时间的 React 组件。

需要：
- 显示小时:分钟:秒（如 14:30:45）
- 每秒自动更新

不需要：
- 不要时区选择
- 不要格式切换
- 不要用任何第三方库
- 不要添加样式（我自己加）

给我最简单的实现，越简单越好。

📌 一句话法则

明确告诉 AI「不要什么」，和「要什么」同样重要。

五大错误速查表

错误	症状	修正法则
一次说太多	AI 输出很长但每个功能都不完整	一次只让 AI 做一件事
一次说太少	AI 给的是「通用模板」不符合你的场景	补充三层上下文
期待读心	AI 的理解和你想的不一样	说清楚验收标准
忽视格式	输出格式每次都不一样	先画出格式的「样子」
不做约束	AI「加戏」，做了很多你不需要的	用「不做清单」限制范围

提问前自检清单

在按下发送键之前，快速过一遍：

范围是否聚焦：这次只让 AI 做一件事？
上下文是否充足：AI 有足够的背景信息吗？
目标是否明确：说清楚了「什么算完成」？
格式是否指定：告诉 AI 想要什么样的输出格式？
边界是否清晰：说明了「不要什么」？

不需要每次都完美，但避开这五个常见错误，你的 AI 对话质量会提升一大截。

本节要点

✓ 错误 1：一次说太多 → 分步骤拆解，一次只做一件事

✓ 错误 2：一次说太少 → 补充三层上下文，把 AI 当实习生

✓ 错误 3：期待读心 → 明确目标，给出验收标准

✓ 错误 4：忽视格式 → 先画出格式的「样子」

✓ 错误 5：不做约束 → 用「不做清单」限制 AI 的发挥空间

下一步

你已经掌握了提示词工程的基础原理，知道了该告诉 AI 什么，也知道了要避开哪些坑。

但你可能还在想：有没有更系统的方法，让我每次都能写出高质量的提示词？

下一节，我们会学习结构化提示词框架——一套可以直接套用的「公式」，让你从「随便说说」升级到「有章可循」。