Cursor 上手指南——从装好到真正会用，你需要越过这道坎
第1章：Cursor 上手指南——从装好到真正会用，你需要越过这道坎
大多数人装好 Cursor 的第一周：把它当更好的代码补全用，效率提升有限，然后困惑"为什么别人说这么好用"。真正的转变发生在你把它当协作者而不是工具的那一刻——你描述意图，它写代码，你审查决策。本章让你跳过那一周的摸索期。
思维模型：从"自动补全"到"协作开发"
Cursor 和 GitHub Copilot 的本质区别不是功能，是交互模型。
Copilot 是被动的：你写代码，它猜测你下一行想写什么，补全。你还是主导者，它是加速器。
Cursor 是主动的：你描述你想要什么，它写完整的实现，你审查和调整。角色翻转了——AI 是执行者，你是决策者。
这个翻转需要适应期。很多人用了一周 Cursor 还是用"补全"的方式，相当于买了一辆汽车当自行车骑。
核心思维转变：不要问"我怎么写这段代码"，要问"我怎么告诉 AI 我要什么"。
Cursor 的三种模式和适用场景
模式1：Inline Edit（快捷键 Cmd/Ctrl+K）
在光标位置直接触发，适合：
- 修改当前选中的代码片段
- 快速生成一个函数
- 注释、重命名、简单重构
使用场景：你已经知道要改什么，只是需要 AI 帮你写。
模式2：Chat（侧边栏）
对话式交互，可以引用文件，适合：
- 理解陌生代码（"这个函数做什么？"）
- 探索设计方案（"实现用户认证有哪几种方式？"）
- 调试思路（"这段代码为什么会出现 race condition？"）
使用场景：你需要 AI 给建议或解释，还没到写代码的阶段。
模式3：Composer（Cmd/Ctrl+I）
多文件编辑，适合：
- 实现跨多个文件的新功能
- 大型重构
- 生成完整的模块或组件
使用场景：任务涉及多个文件，或者需要 AI 自主规划实现路径。
代码库向量化索引：Cursor 为什么能理解你的项目
Cursor 启动后会索引你的代码库，把代码转成向量存储在本地。这让它在你问"这个项目里哪里处理用户登录"时，能真的搜索代码而不是瞎猜。
索引需要时间，大型项目可能需要几分钟。你可以在右下角看到进度。索引完成后，Chat 里的 @Codebase 引用会变得准确。
实际意义：索引之前，AI 只知道你当前打开的文件。索引之后，AI 知道整个项目的结构，能给出更准确的建议，能找到相关的代码片段。
第一次有效对话：用"情境+目标+约束"结构
很多人的第一次 Cursor 体验："帮我写一个登录功能"→ AI 给了一段通用代码，和你的项目风格完全不搭。
问题不是 AI 差，是 Prompt 没有给 AI 足够的情境。
有效的第一次对话结构：
情境：@src/auth/session.ts 这是我们现有的 Session 管理代码，用的是 JWT。
目标：我需要在 /api/users/:id 路由上实现权限检查，确保用户只能修改自己的数据。
约束：
- 用 Express middleware 形式实现，方便复用
- 错误响应格式要和现有代码保持一致（参考 @src/utils/errors.ts）
- 不要引入新的依赖
这段 Prompt 给了 AI：
- 项目上下文（用 @ 引用相关文件）
- 明确的目标
- 实现约束
AI 输出的代码会和你的项目高度吻合，而不是通用模板。
本章要点
- 思维转变是使用 Cursor 的前提：从"写代码工具"切换到"协作开发伙伴"，你是决策者，AI 是执行者。
- 三种模式对应三种场景：Inline Edit 适合局部修改，Chat 适合探索和理解，Composer 适合跨文件开发。
- 等待索引完成：大型项目里
@Codebase的准确度取决于索引质量，首次使用给它几分钟完成索引。 - 用情境+目标+约束结构写 Prompt：这是让 AI 输出贴合你项目的关键，后续章节会深入展开。
- 审查是必须的，不是可选的：AI 写的代码你必须读懂、理解、认可，再接受。盲目接受是问题的根源，不是效率提升。