Hello,朋友们!如果你正在使用或关注 AI 编程工具,那你一定听说过 Cursor——这个上线两年多还未到 1.0 版本,却已在全球爆火的 AI 编程产品。
距离我们上一次的详细教程(0.44 版本)已经过去了几个月,Cursor 在此期间经历了疯狂的更新迭代,如今已来到 0.50+ 版本,功能和玩法都发生了巨大变革。本教程将带你深入了解最新版本的 Cursor,细数从 0.44 到 0.50+ 的核心功能变革,并分享你可能不知道的新功能、新技巧与新玩法。
> 前置建议:
> * 如果你是 Cursor 新手,建议先了解基础操作,本教程侧重于版本更新和进阶技巧。
> * 如果你已经熟悉旧版本,那我们直接进入新世界的探索之旅!
目录
- 环境准备:安装与配置要点
- 初识新界面:核心模式的演变
- 深入理解三大模式:Ask, Manual, Agent
- 模型选择的艺术:免费、Pro 与 Max 模式
- 玩转聊天(Chat):并发任务与上下文管理
- 指令宝典:Symbol (
@
) 与斜杠 (/
) 命令全解析 - 高级功能(一):MCP (模型上下文协议)
- 高级功能(二):Cursor Rules (真正的分水岭)
- 工作区 (Workspace) 与其他实用更新
- 实战技巧与思路
- 总结
1. 环境准备:安装与配置要点
- 安装与汉化:这部分基础操作不再赘述。
- ⚠️ 重要提示:安装任何扩展(包括汉化包)时,务必关闭系统代理,否则会因网络错误导致搜索失败。这是许多新用户遇到的常见问题。
2. 初识新界面:核心模式的演变
打开最新版的 Cursor,你会发现启动页新增了 Clone repo
和 Connect via SSH
选项,方便直接从 Git 仓库克隆项目或通过 SSH 连接远程服务器进行开发。
进入项目后,核心变化体现在 AI 聊天面板上。
- 旧版 (0.44):核心是
Chat
和Composer
两种模式的切换。 - 新版 (0.46+):取消了 Tab 切换,改为在输入框下方以菜单形式选择模式,并更名为更语义化的三种模式:
Ask
(提问):对应旧版的Chat
模式。Manual
(手动):对应旧版的Composer Normal
模式。Agent
(代理/全自动):对应旧版的Composer Agent
模式。
3. 深入理解三大模式:Ask, Manual, Agent
为了彻底理解这三种模式的区别,我们可以通过一个 Beta 功能——自定义模式 (Custom Mode) 来学习。
> 开启路径:设置 (Settings)
-> Features
-> Chat
-> 勾选 Custom mode
。
在自定义模式的配置中,我们可以看到一个模型可以调用的所有“工具”,这正是理解三种默认模式的关键。
3.1 工具箱解析
1. Search (搜索工具)
Codebase
: 语义搜索整个项目的代码(Ask/Agent 模式自主调用)。Web
: 搜索网络内容(Ask/Agent 模式自主调用,Manual 模式需手动输入@Web
)。Grep
: 精准搜索文件中的关键字或字符串(Ask/Agent 自主调用)。List directory
: 高效读取项目目录结构(Ask/Agent 自主调用)。Search files
: 按名称模糊查找文件(Ask/Agent 自主调用)。Read file
: 读取文件内容,一次最多 250 行 (Max 模式 750 行)(Ask/Agent 自主调用,Manual 需手动选中文件)。Fetch rules
: 获取 Cursor Rules 的内容(Ask/Agent 自主调用,Manual 需手动选中规则)。
2. Edit (编辑工具)
Edit & Reapply
: 编辑和应用文件修改。Delete file
: 删除文件。
3. Run (运行工具)
Terminal
: 在聊天窗口中直接调用和执行终端命令。
3.2 三大模式总结
- 🤖 Agent 模式:全能模式。可以自主调用 所有 Search、Edit、Run 工具。它会主动规划任务、修改代码、运行命令,甚至在出错时自我修复。
- 🗣️ Ask 模式:智能问答模式。可以自主调用 所有 Search 工具,但 不能 编辑文件或运行终端命令。它会根据你的问题,在代码库和网络中寻找答案,并以文本或代码块形式回复。
- 🖐️ Manual 模式:纯手动模式。几乎不自主调用任何工具。它的行为完全由你的指令驱动,比如你用
@
指令明确提供了哪个文件,它才会去读哪个文件。它更加可控,适合执行精准、小范围的修改任务。
4. 模型选择的艺术:免费、Pro 与 Max 模式
最新版 Cursor 的模型计费方式更加清晰。
- 免费模型:如
GPT-4o mini
,Deepseek V3
等,无限制免费使用。 - Pro 高级模型:如
Claude 3.5 Sonnet
,Gemini 1.5 Pro
。Pro 会员每月有 500 次快速请求,用完后转为无限次的慢速请求(速度通常可接受)。 - Max 模式:开启后,高级模型按 Token 计费。提供更大的上下文窗口、更强的推理能力(Agent 模式工具调用上限从 25 次提升到 200 次),适合处理极其复杂或大型的任务。
模型选择建议
> 一句话总结:写代码,首选 Claude!
- 代码生成 (Manual/Agent 模式):
- 首选:
Claude 3.5 Sonnet
,目前公认最强的代码模型。 - 次选:
Gemini 1.5 Pro
。
- 首选:
- 通用问答 (Ask 模式):
Gemini 1.5 Pro
或Claude 3.5 Sonnet
表现都很优秀。
- 推理模型 (带大脑图标 🧠):效果好但速度慢,
Claude
的推理模式会消耗 2 次请求额度,非必要不使用。 - Auto 模式:不推荐,因为它会自动选择模型,导致输出不可控。
5. 玩转聊天(Chat):并发任务与上下文管理
- 上下文切换:新版支持在同一个 Chat 内自由切换模型和模式,解决了旧版本信息不共享的问题。
- 历史记录:点击右上角时钟图标可查看和切换历史 Chat。
- 🚀 并发聊天 (Chat Tabs):这是一个极其重要但隐藏的功能!
- 快捷键
Cmd/Ctrl + T
可以新建一个聊天选项卡 (Tab)。 - 最多支持 3 个并发任务,正在运行的 Tab 会有绿点标记。
- 任务完成后会有提示音(需在
Settings
->Features
->Chat
->Play sound on finish
中开启)。 - 强烈建议:打开 Cursor 后,先按两次
Cmd/Ctrl + T
,直接开启 3 个 Tab,最大化利用并发能力,效率 * 3!
- 快捷键
6. 指令宝典:Symbol (@
) 与斜杠 (/
) 命令全解析
在聊天输入框中,通过特定符号可以唤醒强大的指令功能。
6.1 @
Symbol 指令
-
@files & Folders
: 选中文件或文件夹作为上下文。新版支持直接选中项目根目录。 -
@code
: 选中已打开文件中的代码块。 -
@docs
: 引用预设的在线文档链接。 -
@Git
: 引用 Git 的提交记录。 -
@Web
: 强制模型进行网络搜索。 -
✨
@Past Chats
(新增,超重要!): 引用一个历史 Chat 的内容摘要,解决了新开 Chat 丢失上下文的问题。 -
✨
@Recent Changes
(新增): 引用最近的代码修改,方便基于上次修改进行追问或修复。 -
✨
@Terminal
(新增): 引用终端窗口的输出内容,方便快速定位和解决命令错误。 -
@Cursor Rules
: 手动指定本次对话需要遵循的规则文件。 -
被移除/替代的指令:
@Codebase
: 功能已整合进 Ask/Agent 模式的自主搜索中。@Link
: 功能仍在,直接粘贴链接即可,无需手动输入指令。@Notepad
: 功能即将被移除,不建议再使用。
6.2 #
(井号) 指令
用于聚焦 (Focus) 文件,它告诉模型本次对话的重点应该在这些文件上,但不会立即将文件所有内容加载到上下文中,比 @files
更轻量。
6.3 /
(斜杠) 指令
用于执行快捷功能操作。
Active/Open Files to context
: 快速将当前活动或所有已打开的文件添加到聚焦列表。Reset context
: 重置聚焦列表。- ✨
Generate Cursor Rules
: 非常重要,让 AI 根据你的需求描述,自动生成一个规则文件。
7. 高级功能(一):MCP (模型上下文协议)
MCP 是一种开放协议,它允许大模型以统一的方式调用第三方工具。Cursor 集成了 MCP Client,意味着你可以配置外部工具(MCP Server)来增强其能力。
- 配置方式:
Stdio
模式:在本地通过命令行启动服务,需要本地有相应的运行环境(如 Node.js, Python)。SSE
模式:通过一个 HTTP 链接连接到远程托管的服务,对新手更友好。
- 配置文件:
- 全局配置:在
Settings
->MCP
中添加。 - 项目级配置:在项目根目录创建
.cursor/mcp.json
文件。
- 全局配置:在
- 使用建议:
- 对普通开发者而言,MCP 的实际帮助有限,Cursor 内置工具已足够强大。
- 不要配置过多的 MCP Server,这会增加模型的选择负担,可能导致“降智”。
- 思路转换:与其思考如何 用 MCP,不如思考如何 结合 Cursor 开发 有趣的 MCP Server 或 AI 产品。
8. 高级功能(二):Cursor Rules (真正的分水岭)
Cursor Rules 是区分普通用户和高阶玩家的关键。 它本质上就是可配置的系统提示词 (System Prompt)。
-
规则类型:
- 全局规则:在
Settings
->Rules
中设置,对所有项目生效。 - 项目级规则:在项目根目录
.cursor/rules/
文件夹下创建.mdc
文件。支持多个规则文件。
- 全局规则:在
-
项目规则的 4 种触发方式:
Always
: 始终生效(项目级全局),但优先级低于用户设置的全局规则。Auto Attached
: 当引用的文件匹配预设的正则表达式时触发(如*.js
)。Agent Requested
: AI 根据规则的描述(Description)和你的问题,智能判断是否使用此规则。Manual
: 默认类型,仅通过@Cursor Rules
指令手动选择时才会生效。手动选择时,优先级最高,可覆盖全局规则。
-
如何编写一个好的 Rule?
一个合格的规则文件应包含三个核心部分:- 使用场景 (Context):描述在什么情况下应该使用这个规则。
- 关键规则 (Key Rules):明确规定“应该做什么”和“绝对不要做什么”。
- 示例 (Examples):提供一正一反两个示例,让 AI 更清晰地理解你的意图。
9. 工作区 (Workspace) 与其他实用更新
- 多根工作区:现在可以将多个项目文件夹添加到一个工作区中,方便同时进行前后端等多个项目的开发。Codebase 和 Rules 都会在整个工作区内生效。
- 图片上传:支持多模态,可以直接上传 UI 截图让 AI 实现界面。
- Chat 导出:可将完整的对话记录导出为 Markdown 文件,方便分享和复盘。
- 全局忽略:Cursor 默认配置了一份全局的
.cursorignore
文件,你也可以自定义。 - 后台代理 (Background Agent):一个预览功能,允许在后台或远程环境中运行 Agent 任务,适合执行批量、复杂的自动化任务。
10. 实战技巧与思路
技巧一:如何避免 "AI 降智"?
感觉 Cursor 越用越傻?大概率是上下文太长导致的。
解决方案:保持短上下文,单一职责!
- 一个 Chat 只做一件事:完成一个功能点后,立即新开一个 Chat。
- 利用
@Past Chats
指令:如果新任务需要之前的信息,使用此指令引用历史 Chat 摘要,而不是在同一个长 Chat 里继续。 - 善用 Rules:将重复性的要求(如代码风格、注释规范)固化为 Rules,而不是每次都在对话中强调。
技巧二:如何处理 Agent 模式中途跑偏?
当一个大任务在执行过程中出现问题时:
- 中途暂停:立即点击
Stop
按钮,然后输入补充或修正的描述,让它继续。 - 插入对话:在 Agent 已完成的步骤之间,将鼠标悬浮在文字描述上,点击左侧出现的
+
号,可以插入一个新的输入框,在中间环节进行干预。 - 回滚重来:如果从一开始就错了,点击输入框右下角的
Restore checkpoint
,将代码回滚到任务开始前,然后重新编辑需求。
玩法思路:用 Rules 构建你的专属工作流
这才是玩转 Cursor 的终极奥义!
- 从文档开始:开发一个产品前,先让 AI 帮你完善需求文档(PRD)、原型设计、技术方案等。
- 为文档创建 Rules:为不同类型的文档(PRD、API 文档)编写 Rules,约束其生成格式和内容,甚至使用模板。
- 构建工作流 Rule:编写一个“元规则”(Workflow Rule),用于编排其他任务。例如,一个工作流可以规定:
- 接收到 PRD 后,自动拆解任务并生成待办清单(
TODO.md
)。 - 每完成一个任务,就在清单上标记。
- 每次执行任务前,都先检查待办清单。
- 接收到 PRD 后,自动拆解任务并生成待办清单(
通过不断积累和优化你的 Rules,你会逐步构建出一套完全符合自己习惯的、强大的、自动化的 AI 编程工作流。这比任何现成的通用工作流都更有效。
11. 总结
Cursor 的更新迭代速度飞快,新版本不仅修复了旧版的问题,更带来了颠覆性的功能和玩法。核心的转变在于模式的清晰化、上下文管理的灵活性以及以 Rules 为核心的自动化工作流构建能力。
希望这篇教程能帮助你快速上手新版 Cursor,并激发你探索更高级玩法的热情。现在,打开你的 Cursor,开始构建属于你的 AI 编程超能力吧!