这是一份针对 Cursor, Augment, GitHub Copilot 等“IDE集成式AI”的深度使用指南。

你必须转变思维：网页版AI（ChatGPT/Claude）是“场外顾问”，而 Cursor/Augment 是坐在你旁边的“结对编程搭档”。

最大的区别在于：上下文感知（Context Awareness）。你不再需要手动“喂”代码，而是需要学会如何“指引”AI去看代码。

---

IDE集成式AI (Cursor/Augment) 提问深度指南

一、 核心区别：网页版 vs IDE版

特性	网页版 (ChatGPT / Claude Web)	IDE集成版 (Cursor / Augment)
代码获取	手动复制粘贴。你需要把代码贴进去，不仅麻烦，还容易丢失项目结构信息。	自动读取/索引。它能直接看到你打开的文件、选中的代码，甚至整个项目的依赖关系。
上下文边界	仅限于当前对话窗口。	全库感知。它知道你的 Composer.json 里装了什么，也知道你的 Service 层是如何定义的。
输出方式	输出文本，你复制回编辑器。	直接Diff/Apply。它可以直接修改文件，你只需要点击“Accept”或“Reject”。
提问逻辑	“这是背景，这是代码，请修改。”	“参考 @文件A 和 @文件B，帮我修改当前光标处的逻辑。”

---

二、 IDE 提示词的核心法则：指点江山 (Pointing & Referencing)

在 Cursor 等工具中，写提示词的关键不再是描述背景（因为它能看见），而是精准的引用（Reference）。

1. 善用符号（Cursor 的灵魂）

• @Files: 显式告诉 AI 去读哪个文件。
  • Bad: “帮我改一下用户登录逻辑。”（AI 可能会瞎编一个通用的）
  • Good: “检查 @AuthController.php 和 @User.php，在登录验证中加入状态检查。”
• @Codebase: 全局搜索。
  • 当你不知道代码在哪里，或者涉及全局改动时使用。
  • 例: “@Codebase 查找所有使用原生 mysql_query 的地方，并重构为 PDO。”
• @Docs: 引用文档。
  • Cursor 允许你添加第三方文档链接（如 ThinkPHP 或 Vue 官方文档），AI 会基于文档回答。

2. 选中即聚焦 (Highlighting)

• 高亮代码 = 聚焦上下文。
• 当你选中一段代码并按下 Cmd+K (Cursor) 或 Cmd+L 提问时，AI 会默认：“针对这段选中的代码进行操作”。
• 技巧： 如果你要写一个新函数，先在空白处打个函数名（如 function login()），选中它，然后按 Cmd+K 提问，效果比凭空生成好得多。

---

三、 实战场景与提示词示例 (PHP/Go/Vue)

假设你是一名转型中的 PHP 开发者，正在维护老项目或学习新语言。

场景 1：PHP 老代码重构 (Refactoring)

目标： 将一段复杂的原生 SQL 逻辑重构为服务层调用。

• ❌ 以前的问法（网页版）：
  (复制粘贴一大段代码) “把这段代码优化一下。”

• ✅ Cursor/Augment 问法：

  1. 操作： 打开 OrderController.php，选中那段乱糟糟的代码。
  2. 快捷键： Cmd+K (Edit 模式)
  3. 提示词：

     将这段逻辑提取到 @OrderService.php 中。创建一个名为 processOrder 的新方法。
     要求： 保持参数一致，并在当前控制器中替换为调用新方法。

场景 2：跨语言翻译 (PHP -> Go)

目标： 你想用 Go 语言重写一个 PHP 的加密函数。

• ✅ Cursor 问法：
  1. 操作： 打开空白的 utils.go 文件。
  2. 快捷键： Cmd+L (Chat 模式)
  3. 提示词：

     我是一个PHP开发者，正在学习Go。
     请参考 @Encryption.php 中的 encrypt 方法。
     在当前文件中用 Go 语言实现相同的功能。
     注意： 解释一下 Go 的 crypto/aes 包和 PHP openssl 的区别。

场景 3：Vue 前后端联调 (Frontend & Backend)

目标： 前端 Vue 页面字段对不上后端 PHP 接口。

• ✅ Cursor 问法 (Composer 模式 - Cmd+I 多文件编辑)：
  1. 操作： 打开 Composer (Cursor 的多文件编辑功能)。
  2. 提示词：

     我现在的 @UserProfile.vue 无法显示用户头像。
     请检查后端接口 @UserController.php 的返回值。
     确保前端 <img> 标签绑定的字段名与后端返回的 JSON 字段名一致。
     如果不一致，请同时修改这两个文件以匹配。

---

四、 进阶技巧：Cursor 的 “Composer” (Cmd+I)

这是 Cursor 目前最杀手级的功能。普通的 Chat (Cmd+L) 只能陪聊，Edit (Cmd+K) 只能改当前文件。
Composer (Cmd+I) 可以同时理解并修改多个文件。

提示词模板：

任务： [描述整个功能，例如：增加一个“找回密码”功能]
涉及文件： [列出核心文件，如 @User.php, @routes.php]
参考风格： 参考 @LoginController.php 的写法。
执行： 请直接生成 Controller、Route 和 View 代码。

---

五、 给程序员的“防坑”指南

1. 不要太相信 @Codebase： 虽然它可以搜全库，但有时候不如你直接 @具体文件 准确。如果你知道文件在哪，一定要显式引用。
2. 检查 Diff： IDE 工具会直接改代码，容易把本来是对的代码改错。务必看一眼 Diff（差异对比）再按 Accept。
3. .cursorrules 文件：
   你可以在项目根目录下建一个 .cursorrules 文件，写入全局指令。
   • 示例内容： “本项目使用 Laravel 10，代码必须遵循 PSR-12 标准。所有变量名使用驼峰命名法。总是优先使用中文回复。”
   • 这样你就不用每次都重复这些废话了。

总结

在 Cursor/Augment 中，提示词的公式发生了变化：

• 旧公式 (Web AI): 背景描述 + 代码粘贴 + 需求
• 新公式 (IDE AI): @引用文件 + 选中代码 + 动作指令

下一步行动：
下次你想写一个新功能时，尝试不要切出去找 GPT-4。
在 Cursor 中按下 Cmd+I (Composer)，输入：“参考 @ExistingLogic.php，在 @NewFeature.php 中实现一个类似的逻辑，但把数据源改为 Redis。” 体验一下“全自动编程”的感觉。

---