Cursor代码学习计划：真实场景提示词加入指南
核心判断：仅靠一句“帮我写个 useEffect”这类模糊 Prompt，AI 返回的通常是 React 入门教程的通用大纲——理论正确但实践无效。真正可落地的代码学习方案，必须把你的断点位置、故障记录、刚修复的 bug 全部塞进 Prompt，让 Cursor 明确知道“就是今天、就是这个文件、就是这行代码卡住了你”。
下面详细拆解，如何将这种“具身上下文”转化为 Prompt 的核心组成部分。
第一步：精准锚定你的工作现场
典型场景：你正停留在 /src/pages/checkout/AddressForm.tsx 第 58 行，光标就落在 useEffect 依赖数组的末尾。按下 Cmd + K（Windows 下 Ctrl + K）调出命令面板后，如果仅写“帮我优化这个 useEffect”，返回的将是一堆泛泛之谈。
务必在 Prompt 开头明确写入：【光标位于 AddressForm.tsx:58】。然后补充：该行 useEffect 第二个参数是 [customer, isEditing]，但实际校验逻辑依赖 shippingMethods，由于遗漏该依赖导致地址校验跳过。仅这一句，就能把 Cursor 的注意力从“通用 useEffect 原则”拽到“为什么 shippingMethods 没有触发重试”这个具体变量遗漏问题上。忽略此步骤，Cursor 会立刻切换至《useEffect 依赖原则》的教学模式，而不是帮你补上关键的 shippingMethods。
第二步：注入刚发生的线上故障详情
仅提供行号只能让 Cursor 定位到问题代码，但补充故障现场后，它能从“修复代码”升级到“预判影响范围”。6 月 15 日 14:22，订单页因 AddressForm 组件未监听 shippingMethods 变更导致地址校验跳过，影响了 372 笔跨境订单——此信息必须写入 Prompt。具体写法：“*6 月 15 日 14:22 线上故障，AddressForm 组件未监听 shippingMethods 变更，地址校验跳过，影响 372 笔跨境订单。*”这句话能将修复优先级和影响范围深刻植入 AI 的决策逻辑中。
更进一层：直接绑定 Sentry 错误 ID。把 d4f9a2b3-c1e7-4820-bc0d-7a8e5f1a2b3c 注入，并附上堆栈片段——堆栈显示 useEffect 内调用 validateAddress() 时 shippingMethods 仍为 undefined。此时 Cursor 会立刻聚焦于“如何安全读取异步加载的 shippingMethods”，而非空谈 useEffect 最佳实践。若不提供堆栈，它会误以为你在学习基础。
第三步：结合团队近期 PR 与会议决策
修好当前 bug 只是第一步，还需让代码与团队未来数周的方向对齐。打开终端，执行 git log --oneline -n 5 确认当前分支为 feature/checkout-v2。然后在 Prompt 中明确：“本学习计划需支撑 feature/checkout-v2 分支中‘地址校验与运费联动’需求，该需求已于 6 月 16 日晨会确认技术方案为‘shippingMethods 加载完成后再触发校验’。”仅此一句，就能使 Cursor 返回的方案避开“先校验再加载运费”的错误路径。
还有一个常见陷阱：务必追加一句约束——“禁止引入新的状态管理库，复用现有 zustand store 中的 useShippingStore()”。若省略此句，Cursor 很可能在方案中提议改用 Redux Toolkit，导致下周需要重构仓库，与团队技术栈产生冲突。一句话即可让 AI 沿正确方向推进，何必多走弯路？
第四步：绑定当前使用的调试工具链
有时会遇到更棘手的场景：Chrome DevTools 的 Network 面板显示 shippingMethods 返回数据正常，但同一组件的 React DevTools Props 面板中 shippingMethods 字段始终为空。此矛盾常困扰初学者。直接将这句话写入 Prompt：“当前在 React DevTools 中观察到 shippingMethods props 为空，而 Network 响应体含有效数据，说明问题出在 props 透传链路而非 API 层。”听到此描述，Cursor 会立刻跳过“什么是 React Props”的基础，直接深入 useMemo 是否阻断了 props 更新。这才是真正与你的调试动作绑定的学习路径，而非干巴巴的课程大纲。
因此，下次编写 Prompt 前，先暂停光标，将终端信息、故障日期、Sentry ID、分支名、DevTools 观察结果全部打包。不要让 Cursor 对着空气讲课，也不要让它“自学成才”——你已经在断点中踩过一遍，只需让它循着你的脚印前进即可。