AI 编程 Prompt 写法指南
同样一个需求，表达方式不同，AI 给出的代码质量可能天差地别。写好 Prompt 是 AI 编程里性价比最高的技能之一。
这篇指南总结编程场景下稳定有效的 Prompt 写法，并给出可直接套用的结构。
一个好的编程 Prompt 包含什么
Section titled “一个好的编程 Prompt 包含什么”与其追求“魔法咒语”，不如保证信息完整。一个结构清晰的编程 Prompt 通常包含四部分：
- 目标：你想要它做什么，一句话说清。
- 上下文：相关文件、技术栈、依赖、现有约定。
- 约束：必须遵守的规则，比如不改动公共 API、保持现有风格。
- 期望输出：要代码还是要方案，要不要解释，要不要测试。
通用结构模板
Section titled “通用结构模板”下面是一个可以反复套用的骨架：
目标：<一句话描述要做的事>背景：<技术栈 / 相关文件 / 现有实现>要求：- <约束 1>- <约束 2>输出：<只要代码 / 代码 + 简要说明 / 先给方案再实现>几种高频模式
Section titled “几种高频模式”让它先给方案，再写代码
Section titled “让它先给方案，再写代码”复杂任务不要一上来就要代码。先让它列出思路和步骤，你确认方向后再让它实现，能显著减少返工。
先不要写代码。请先说明你打算如何实现这个功能，分几步，每步改动哪些文件。我确认后再让你写。给正例约束风格
Section titled “给正例约束风格”与其描述风格，不如直接贴一段现有代码：“按这段代码的风格和命名习惯来写。”
完成后，请检查：是否有未处理的边界情况？是否有潜在的空指针或越界？如果有，直接修正。编程 Prompt 的常见错误
Section titled “编程 Prompt 的常见错误”- 上下文缺失：不给相关代码，AI 只能猜，容易产出与项目脱节的代码。
- 目标太大：一次让它实现整个功能，难验证也难定位问题。拆小步。
- 不给约束：不说明就默认它会破坏现有结构，结果常常需要返工。
- 从不复用：每次重写 Prompt。把好用的固化成 Prompt 模板。
不同工具的差异
Section titled “不同工具的差异”CLI 工具（如 Claude Code、Codex）能直接读取项目文件，你不必把代码贴进 Prompt，但要把任务和约束讲清楚。网页对话则需要你主动提供上下文。
常见问题（FAQ）
Section titled “常见问题（FAQ）”Prompt 越长越好吗？
Section titled “Prompt 越长越好吗？”不是。要的是相关信息完整，而不是字数多。无关的废话反而稀释重点。
需要背很多“咒语”吗？
Section titled “需要背很多“咒语”吗？”不需要。结构清晰、上下文充分，比堆砌技巧词更有效。
怎么持续提升？
Section titled “怎么持续提升？”把每次有效的 Prompt 记录下来，整理成模板。可以从 Prompt 模板页 开始积累。