Cursor 编辑器使用指南

📖 目录

• 简介
• 核心功能
• AI 交互模式
• 模型选择
• 快捷工具栏
• Web 搜索功能
• 引用功能详解
• 快捷键大全
• Agent 高级功能
• 使用建议
• 总结
• 参考资源

---

简介

Cursor 是一款由 AI 驱动的代码编辑器，能够理解你的代码库，并通过自然语言助你更快编写代码。只需描述你想要构建或修改的内容，Cursor 就会为你生成相应的代码。

Cursor 基于 VS Code 构建，将强大的 AI 能力深度集成到开发环境中，让编程变得更加高效和智能。

---

核心功能

1. AI 聊天 (Chat)

• 快捷键：Ctrl + L（默认切换侧边栏，通常绑定到 Chat 模式）
• 功能：AI 对话界面，支持多个标签页、会话历史、检查点和导出功能
• 特点：
  • 可以向 AI 提问编程问题、解释代码、寻求建议
  • 支持选中代码后提问，AI 会针对选中内容回答
  • 使用 Ctrl + T 创建新标签页，每个标签页保留各自的上下文和历史记录
  • 选中代码后按 Ctrl + L 会将选中内容添加到新的聊天
  • 支持聊天历史记录（Alt + Ctrl + ' 查看过往对话）
  • 支持导出对话为 Markdown 格式
  • 支持检查点功能（自动快照，可恢复到先前状态）
  • 支持并行对话（多个标签页同时工作）

2. Agent（代理模式）

• 快捷键：Ctrl + I（默认切换侧边栏，通常绑定到 Agent 模式）
• 功能：Cursor 的助手，能够独立完成复杂的编码任务、运行终端命令并编辑代码
• 特点：
  • 自动读取和分析代码文件
  • 在项目中搜索相关代码
  • 创建、修改、删除文件
  • 执行终端命令（安装依赖、运行测试等）
  • 多步推理，自主规划任务
  • 支持浏览器交互、工具使用、检查点、待办列表等功能

3. 内联编辑 (Inline Edit)

• 快捷键：Ctrl + K
• 功能：在代码中直接唤出 AI 进行局部修改
• 特点：
  • 使用自然语言编辑所选代码
  • 在原位置即时查看效果
  • 适合快速修复或小范围调整
  • 按 Enter 提交，Ctrl + Shift + Backspace 取消

4. 代码补全 (Tab)

• 触发方式：自动触发，按 Tab 接受建议
• 功能：可预测多行代码修改的代码补全功能
• 特点：
  • AI 会根据当前代码和最近更改生成建议
  • 理解代码库上下文，提供超越简单语法补全的智能建议
  • 按 Ctrl + → 接受建议的下一个单词

5. 常用快捷键

功能	快捷键
打开命令面板	Ctrl + Shift + P
快速打开文件	Ctrl + P
打开终端	Ctrl + `
切换侧边栏	Ctrl + B
切换 Agent 布局	Ctrl + E
模式菜单	Ctrl + .
在 AI 模型之间循环切换	Ctrl + /
切换模型	Ctrl + Alt + /
切换语音模式	Ctrl + Shift + Space
Cursor 设置	Ctrl + Shift + J
新建聊天标签页	Ctrl + T
新建聊天	Ctrl + N / Ctrl + R
上一个聊天	Ctrl + [
下一个聊天	Ctrl + ]
关闭聊天	Ctrl + W

注意：Ctrl + I 和 Ctrl + L 默认都是"切换侧边栏"，但通常会被绑定到不同的模式：

• Ctrl + I 通常绑定到 Agent（Composer）模式
• Ctrl + L 通常绑定到 Chat 模式

如果快捷键行为与预期不符，可以在 Cursor 的键盘快捷键设置中查看和修改这些绑定。

---

AI 交互模式

Cursor 提供了四种不同的 AI 交互模式，每种模式适用于不同的场景：

∞ Agent（代理模式）

• 特点：最强大的模式，AI 会自主行动完成任务
• 快捷键：Ctrl + I
• 能力：
  • 自动读取和分析代码文件
  • 在项目中搜索相关代码（语义化代码库搜索）
  • 创建、修改、删除文件
  • 执行终端命令（安装依赖、运行测试等）
  • 多步推理，自主规划任务
  • 浏览器交互（测试应用、收集信息）
  • 使用工具（MCP 集成、代码库搜索、终端执行）
  • 创建检查点（自动快照，可恢复到先前状态）
  • 管理待办列表（为复杂项目创建结构化任务列表）
  • 差异审查（在接受更改前先审查，以颜色区分新增与删除）
• 适用场景：
  • “帮我创建一个 React 登录页面”
  • “找出项目中所有的 bug 并修复”
  • “给这个项目添加单元测试”
  • “重构这个模块的代码结构”
  • “测试这个 Web 应用的功能”

⚙ Plan（计划模式）

• 特点：AI 会先制定计划，让你确认后再执行
• 优势：更可控，适合不想让 AI 直接改代码的情况
• 适用场景：
  • “帮我规划一下如何重构这个模块”
  • “设计一个用户认证系统的架构”
• 工作流程：先看方案 → 确认 → 再执行

🔧 Debug（调试模式）

• 特点：专门针对错误排查优化
  这个过程，还比较有意思，他会自己加入一些log日志，然让你你运行程序，然后它自己再读取日志判断程序在哪出了问题。
• 功能：
  • 分析报错信息
  • 定位问题原因
  • 提供修复建议
• 适用场景：
  • 代码运行出错
  • 测试失败
  • 性能问题排查

💬 Ask（问答模式）

• 特点：只回答问题，不做任何修改
• 功能：不会修改任何文件，纯粹回答问题
• 适用场景：
  • 学习编程知识
  • 解释代码逻辑
  • 讨论技术方案
  • 概念理解

模式选择建议

你想要…	选择模式
AI 帮你干活	Agent
先看计划再执行	Plan
修 Bug	Debug
只是聊聊	Ask

---

模型选择

Cursor 支持多种 AI 模型，你可以根据需求选择最适合的：

开关选项

选项	作用
Auto	自动根据任务选择最合适的模型
MAX Mode	开启后使用更强的模型能力，消耗更多额度

可选模型

模型	提供商	默认上下文	Max 模式	功能特性	适用场景
Claude 4.5 Opus 🧠	Anthropic	200k	200k	Agent、思考、图片	复杂任务、高质量输出
Claude 4.5 Sonnet 🧠	Anthropic	200k	1M	Agent、思考、图片	日常编程、平衡速度
Composer 1	Cursor	200k	-	Agent、图片	通用编程任务
Gemini 3 Flash 🧠	Google	200k	1M	Agent、思考、图片	快速响应、简单任务
Gemini 3 Pro 🧠	Google	200k	1M	Agent、思考、图片	平衡性能与质量
GPT-5.1 Codex Max 🧠	OpenAI	272k	-	Agent、思考、图片	专业代码生成
GPT-5.2 🧠	OpenAI	272k	-	Agent、思考、图片	通用任务
Grok Code 🧠	xAI	256k	-	Agent、思考	代码相关任务

🧠 图标含义：带 🧠 的表示支持深度思考/推理能力（Thinking capability）

功能特性说明：

• Agent：支持工具使用能力
• 思考：使用推理令牌进行深度思考
• 图片：支持图片输入

模型选择建议

需求	推荐模型
复杂任务、高质量输出	Claude 4.5 Opus
日常编程、平衡速度	Claude 4.5 Sonnet（Max 模式 1M 上下文）
快速响应、简单任务	Gemini 3 Flash
专业代码生成	GPT-5.1 Codex Max
需要大上下文窗口	Claude 4.5 Sonnet（Max 模式）或 Gemini 3 Pro（Max 模式）
不想选，让系统决定	开启 Auto

---

快捷工具栏

聊天输入框下方有一排快捷工具栏，提供多种功能：

按钮功能说明

图标	名称	功能
○	上下文	显示上下文使用情况（50%表示已经使用过半）
@	引用/提及	快速引用文件、代码库、文档等
🌐	Web 搜索	让 AI 搜索互联网获取最新信息
🖼️	添加图片	上传图片让 AI 分析
🎤	语音输入	用麦克风说话，语音转文字输入

详细用法

○ 添加上下文

• 点击后可以选择项目中的文件/文件夹
• 让 AI 了解更多背景信息
• 提高回答的准确性

@ 引用功能

常用的引用方式：

命令	作用
@文件名	引用特定文件
@Codebase	搜索整个代码库
@Web	搜索网络
@Browser	使用浏览器访问网页
@Docs	引用文档
@Git	引用 Git 相关信息

🌐 Web 搜索

• 获取最新的技术文档、解决方案
• 适合问"最新版本怎么用"之类的问题
• 让 AI 获取实时信息

🖼️ 图片上传

• 上传截图让 AI 分析
• 适用场景：
  • 错误截图分析
  • UI 设计稿参考
  • 界面效果展示

🎤 语音输入

• 懒得打字就直接说！
• 语音会自动转成文字
• 提高输入效率

---

Web 搜索功能

搜索选项

选项	作用
Off	关闭 Web 搜索
Browser Tab	使用 Cursor 内置浏览器搜索
Google Chrome	使用你电脑上的 Chrome 浏览器搜索
Manage Settings	打开设置页面，进行更多配置

选项区别

🔴 Off（关闭）

• AI 不会搜索网络
• 只依赖已有知识回答
• 适合：不需要最新信息的场景

🟢 Browser Tab（内置浏览器）

• 使用 Cursor 自带的浏览器功能
• 在编辑器内完成搜索，不用切换窗口
• 适合：一般网络搜索需求

🟢 Google Chrome（外部浏览器）

• 调用你电脑上安装的 Chrome
• 适合：需要登录账号访问某些网站的情况

使用建议

场景	推荐选择
不需要最新信息	Off
想让 AI 搜索最新资料	Browser Tab
需要访问需登录的网站	Google Chrome

---

引用功能详解

@Browser

• 作用：让 AI 使用浏览器能力访问网页
• 功能：
  • 访问网页并读取内容
  • 获取最新的技术文档、API 文档
  • 获取实时数据
  • 执行浏览器操作（点击、填写表单、截图等）
• 使用示例：

  @Browser 帮我查看 React 官网的最新文档
  @Browser 搜索一下 Python 3.12 的新特性
  @Browser 访问这个 API 文档：https://api.example.com/docs
  

其他 @ 功能对比

功能	用途
@Browser	访问网页、获取网络信息
@Web	搜索互联网（类似 Google 搜索）
@Codebase	搜索你的代码库
@文件名	引用项目中的文件
@Docs	引用文档
@Git	引用 Git 相关信息

---

快捷键大全

Chat 相关快捷键

快捷键	功能
Enter	轻推（默认发送消息）
Ctrl + Enter	排队发送消息 / 强制发送消息（输入时）
Ctrl + Shift + Backspace	取消生成
Ctrl + Shift + L	将选中代码添加为上下文
Ctrl + V	将剪贴板内容添加为上下文（代码或日志）
Ctrl + Shift + V	将剪贴板内容填入输入框
Ctrl + Enter	接受所有更改（有建议更改时）
Ctrl + Backspace	拒绝所有更改
Tab	切换到下一条消息
Shift + Tab	在 Agent 模式间切换
Ctrl + Alt + /	切换模型
Ctrl + N / Ctrl + R	新建聊天
Ctrl + T	新建聊天标签页
Ctrl + [	上一个聊天
Ctrl + ]	下一个聊天
Ctrl + W	关闭聊天
Esc	移除输入框焦点
Alt + Ctrl + '	查看聊天历史记录

代码选择与上下文

快捷键	功能
@	打开 @ 提及功能
/	快捷命令
Ctrl + Shift + L	将选中内容添加到聊天
Ctrl + Shift + K	将选中内容添加到编辑
Ctrl + L	将选中内容添加到新的聊天
Ctrl + M	切换文件读取策略
Ctrl + →	接受建议的下一个单词
Ctrl + Enter	在聊天中搜索代码库
选中代码 + Ctrl + C + Ctrl + V	将复制的引用代码添加为上下文
选中代码 + Ctrl + C + Ctrl + Shift + V	将复制的代码添加为文本上下文

内联编辑快捷键

快捷键	功能
Ctrl + K	打开内联编辑
Ctrl + Shift + K	切换输入焦点
Enter	提交
Ctrl + Shift + Backspace	取消
Alt + Enter	快速提问

Tab 代码补全快捷键

快捷键	功能
Tab	接受建议
Ctrl + →	接受下一个单词

终端快捷键

快捷键	功能
Ctrl + K	打开终端命令输入栏
Ctrl + Enter	运行生成的命令
Esc	确认命令

---

使用建议

1. 描述清晰

向 AI 提问时，尽量描述清楚你的需求，包括：

• 具体要实现什么功能
• 使用什么技术栈
• 有什么特殊要求

2. 提供上下文

使用 @ 引用相关文件，帮助 AI 更好理解：

• @文件名 - 引用具体文件
• @Codebase - 让 AI 搜索整个代码库（语义化搜索）
• @文件夹名 - 引用整个文件夹
• @Git - 引用 Git 相关信息
• @Docs - 引用文档
• @Browser - 使用浏览器访问网页
• @Web - 搜索互联网

代码库索引：

• Cursor 会对代码库进行语义分析
• 支持代码搜索、引用查找和上下文感知的智能建议
• 让 AI 更好地理解你的项目结构

规则（Rules）：

• 用于定义 AI 行为的自定义指令
• 设置代码规范、框架偏好和项目特定约定
• 帮助维护编码标准、规范模式，并个性化 Agent 协助项目的方式

3. 分步操作

复杂任务可以拆分成小步骤逐步完成：

• 先规划（使用 Plan 模式）
• 再执行（使用 Agent 模式）
• 最后检查

4. 检查代码

AI 生成的代码建议仔细审查后再使用：

• 检查逻辑是否正确
• 确认是否符合项目规范
• 测试功能是否正常

5. 善用快捷键

提高效率的快捷键：

• Ctrl + L - 打开聊天（选中代码时会将选中内容添加到新的聊天）
• Ctrl + I - Agent 模式
• Ctrl + K - 内联编辑
• Ctrl + T - 新建聊天标签页（并行工作流）
• Ctrl + Shift + L - 将选中内容添加到聊天
• Ctrl + Shift + K - 将选中内容添加到编辑
• Ctrl + P - 快速打开文件
• Ctrl + E - 切换 Agent 布局
• Ctrl + . - 打开模式菜单

6. 模式选择

根据任务类型选择合适的模式：

• 日常开发 → Agent 模式
• 复杂重构 → Plan 模式 → Agent 模式
• 调试问题 → Debug 模式
• 学习知识 → Ask 模式

---

总结

Cursor 是一款功能强大的 AI 编程助手，通过合理使用各种功能和模式，可以大大提高开发效率。关键是要：

1. 了解不同模式的特点，选择最适合的

   • Agent 模式：让 AI 自主完成复杂任务
   • Chat 模式：与 AI 对话，获取帮助和建议
   • Plan 模式：先看计划再执行
   • Debug 模式：专门用于错误排查
   • Ask 模式：只回答问题，不修改代码

2. 善用引用功能，提供足够的上下文

   • 使用 @ 引用文件、代码库、文档等
   • 利用代码库索引进行语义化搜索
   • 设置规则来定义 AI 行为

3. 描述清晰，让 AI 理解你的需求

   • 具体说明要实现的功能
   • 提供技术栈信息
   • 说明特殊要求

4. 检查代码，确保质量

   • 使用差异审查功能
   • 利用检查点功能安全尝试不同方案
   • 仔细审查 AI 生成的代码

5. 善用快捷键，提高工作效率

   • 掌握常用快捷键
   • 使用标签页进行并行工作流
   • 利用内联编辑快速修改代码

希望这份指南能帮助你更好地使用 Cursor！🚀

---

参考资源

• Cursor 官方文档
• Cursor 学习指南
• Cursor 更新日志
• Cursor 论坛

---

---

Agent 高级功能

检查点（Checkpoints）

• 功能：自动快照会跟踪 Agent 的更改
• 用途：若更改不符合预期，或想尝试不同方案，可恢复到先前状态
• 优势：安全地尝试不同的实现方案，不用担心丢失工作

待办（Planning）

• 功能：Agent 会为复杂项目创建并管理结构化任务列表
• 用途：将待办用作规划文档，把工作拆解为可管理的步骤，并跟踪进度
• 优势：清晰了解任务进展，更好地管理复杂项目

Hooks

• 功能：通过自定义 hooks 扩展 Agent 能力
• 用途：创建可复用函数，将其集成到你的工作流程中，并自动化重复任务
• 优势：提高工作效率，减少重复性工作

并行 Agent

• 功能：使用 Ctrl + T 同时打开多个对话
• 特点：每个标签页都保留各自的上下文、历史记录和模型选择
• 用途：需要并行工作流时，可以同时进行多个任务

差异审查

• 功能：在接受更改前先审查
• 特点：审阅界面以颜色区分新增与删除，帮助你精准掌控修改
• 优势：确保代码质量，避免意外更改

浏览器交互

• 功能：Agent 可与浏览器交互
• 用途：用于测试应用、收集信息，并自主完成各类基于网页的任务
• 优势：自动化 Web 测试和信息收集