Cursor 入门教程：十分钟上手 AI 编程环境

从代码补全插件到 AI 原生编辑器

Cursor 与 GitHub Copilot 等工具的根本区别，在于它并非一个附加在编辑器上的补全插件，而是从零开始以 AI 为核心接口构建的代码环境。这一定位决定了它的能力上限：AI 能够读取整个代码库、理解每个文件的上下文、跨多个文件同时修改、运行终端命令、检查测试是否通过、修复自身错误并持续迭代，直到任务真正完成。

这套设计背后是一种新的工作模式转变——你成为架构师和审阅者，而 AI 成为构建者。你的职责是说明需要发生什么并验证结果，AI 负责具体执行。理解这个分工，是用好 Cursor 的前提。

对已经使用 VS Code 的开发者来说，迁移成本极低：切换到 Cursor 大约只需两分钟，原有的扩展、主题和快捷键都会随之迁移。而对从未接触过 VS Code 的新手，反而没有旧习惯的包袱，上手更加干净。

注册、下载与套餐选择

上手第一步是访问 Cursor.com 注册账号，然后下载对应平台（如 Windows）的客户端。它本质上就是你电脑上的一款代码编辑器。

在套餐方面，Cursor 提供了分层定价：

• Hobby（免费）：有限使用额度，适合入门体验，覆盖大部分学习和轻度使用场景。
• Pro（每月 20 美元）：提供无限补全和完整的代理模式访问，是真正释放全部能力的门槛。
• Pro Plus / Ultra：面向更重度需求，提供更高额度与更多功能。

对初学者而言，免费的 Hobby 计划已足以完成入门学习和小型项目实践。

一个必须先打开的关键设置：仓库索引

在正式动手前，有一项设置值得优先处理。打开 Cursor 自身的设置面板（注意不是 VS Code 的设置），找到「代码智能」相关选项，开启索引仓库功能。

开启后，AI 会感知你的整个项目，而不仅仅是当前打开的单个文件。索引与未索引状态下，Cursor 的分析质量差别相当大。如果你希望得到深入、贴合项目全局的回答，就应该把它打开。

三种核心交互模式：先理解再执行

了解在什么场景使用哪种模式，是让 Cursor 其他功能真正发挥作用的核心技能。Cursor 提供三种基本交互模式，通常可以按顺序串联使用。

询问模式（Ask）：只读理解

询问模式用于提问和理解，本质上是一种只读分析。你不是让它改动任何东西，而是让它解释某些内容——比如「这个函数是做什么的」「这个错误是怎么发生的」。此时它更像一个聊天机器人，帮你在采取行动前先厘清上下文。

计划模式（Plan）：执行前的策略审查

计划模式用于在真正修改文件之前规划方案。你描述想要实现的功能或更改，AI 先给出策略，你可以审查并批准。这对复杂任务尤其有价值，能避免 AI 在你意识到方法有误之前，就已经朝错误方向做了大量实质改动。

代理模式（Agent）：自主构建

代理模式是最强大、也最能定义 Cursor 的模式。你只需描述一个任务目标，比如「构建一个用户身份验证系统」，Cursor 的代理会自主读取相关文件、编写代码、运行终端命令、检查测试是否真正通过并修复失败，一直持续到任务完成。你负责审查最终成果，而不是逐步指导每一步。

视频中的演示里，代理模式直接创建了一个可在本地主机运行的完整应用，并自动打开预览，你还能根据需求继续修改代码。

一个高效的工作流往往是：先用询问理解上下文，再用计划统一方法，最后用代理执行。

代理模式在技术层面依赖于「工具调用」（Tool Use）能力：AI 模型不仅生成文本，还能调用预定义的工具接口——读取文件、写入文件、执行 Shell 命令、搜索代码库等。每次工具调用的结果会被反馈回模型，形成一个感知-行动-观察的循环，直到模型判断任务完成。这也意味着代理模式的质量高度依赖所选底层模型的推理能力（如 Claude 3.5 Sonnet 或 GPT-4o），不同模型在复杂任务上的表现差异显著。由于代理会自主执行终端命令，在生产代码库或有敏感数据的项目中使用时，建议先在分支环境中操作，并认真审查每一次文件变更，避免不可逆的副作用。

日常提效的四个功能

除了三种模式，Cursor 还内置了一系列贴合日常编码的功能。

标签补全（Tab）

这是最直接、使用最广、运行最稳的功能。AI 会在你输入时预测接下来要写的代码行或代码块，按下 Tab 键即可接受，能显著提升编写速度。

行内编辑（Ctrl+K）

选中任意一段代码，用自然语言给出指令，比如「把这段改写为使用 await 而不是 promise」或「为这个函数添加错误处理」，Cursor 会按指令自动修改。更重要的是，接受前会有一个审查界面，精确显示哪些地方发生了变化，你可以选择保留或撤销。

这种审查习惯，正是熟练使用者与「最终得到自己不理解、不信任的代码」的人之间的分水岭。

作曲家（Composer，Ctrl+I）

按下 Ctrl+I 进入作曲家界面，你可以在此写任何需求，它会生成相应代码，尤其适合多文件协作的工作。

项目规则（Project Rules）

项目规则用于确保整个代码库的风格和架构保持一致，让 AI 生成的代码符合你既定的规范。

项目规则本质上是写入代码库的「系统提示」（System Prompt），通常以 .cursorrules 文件或专属配置存储在项目根目录，会在每次 AI 交互时自动注入上下文。你可以在其中指定技术栈偏好（如「始终使用 TypeScript 严格模式」）、命名规范、禁止使用的 API、测试覆盖要求，甚至团队内部的架构原则。对于多人协作的项目，将这个文件纳入版本控制，能确保所有成员获得一致的 AI 辅助行为，避免同一项目里出现风格割裂的 AI 生成代码。

写在最后

Cursor 是当前最强大的 AI 编程环境之一，但懂得如何使用它的人，和仅仅把它当作「稍微聪明一点的自动补全」的人之间，技能差距非常大。

把这些能力拆开看：标签补全提升编写速度，行内编辑做针对性修改，作曲家处理多文件工作，代理模式自主构建功能，项目规则维持全局一致性——它们被集成在一起，构成一套完整的 AI 辅助开发体系。真正的建议只有一个：从今天起创建一个项目，在实践中把这些功能逐个用起来。