必须放参考样例时是需严格遵循项目代码风格、接口契约或业务逻辑模式；可不放样例时是生成结构清晰的一次性工具脚本；正确姿势包括单文件内嵌、跨文件引用+说明、结构化对比样例。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Cursor中写脚本时，提示词里是否放参考样例，直接影响生成代码的准确性、结构匹配度和上下文适配性——不加样例常导致AI自由发挥偏离项目规范，加错样例反而会污染模型理解。
什么情况下必须放参考样例
当你需要生成的脚本必须严格遵循已有代码风格、接口契约或业务逻辑模式时，必须提供参考样例。例如：项目中所有CLI脚本都使用yargs且参数格式统一为--input <path></path>，而你新写的process-logs.js若不给样例，Cursor可能默认用commander或自创参数语法，导致后续集成失败。
操作路径：打开一个已有的同类脚本文件→全选复制→粘贴到Cmd+K提示框开头，用// 参考样例：标注。
【样例必须来自当前项目，禁止用网上搜来的通用代码】
什么情况下可以不放参考样例
生成一次性工具脚本，比如临时清洗CSV、批量重命名文件、抓取页面标题等简单任务，直接描述输入输出即可。例如：“写一个Python脚本，读取./data/*.csv，把每行第3列转大写，保存到./output/同名文件”。这类需求结构清晰，Cursor基于内置模式就能准确响应。
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
这一步操作起来很简单，直接把自然语言需求敲进去就行。
放样例的三种正确姿势
方法一：单文件内嵌样例
在提示词开头用三反引号包裹一段真实代码，后面紧跟需求描述。适合逻辑简单、复用性强的函数级脚本。
方法二：跨文件引用+说明
输入@src/utils/file-helper.ts → 换行写“参照该文件的错误处理方式，写一个读取JSON配置并校验schema的Shell脚本”。Cursor会自动加载对应文件内容作为上下文。
方法三：结构化对比样例
给出“期望输入”和“期望输出”各一段真实数据，再写需求。例如：
# 输入样例：echo "user_123,active,2026-05-30" | ./parse-user.sh
# 输出样例：{id: "user_123", status: "active", updated: "2026-05-30"}
然后接“请用Bash实现上述解析逻辑”。这种方式对格式敏感型脚本（如日志解析、ETL）成功率最高。
