天津市网站建设_网站建设公司_留言板_seo优化

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 + 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（调试模式）

• 特点：专门针对错误排查优化
• 功能：
  • 分析报错信息
  • 定位问题原因
  • 提供修复建议
• 适用场景：
  • 代码运行出错
  • 测试失败
  • 性能问题排查

💬 Ask（问答模式）

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

模式选择建议

模型选择

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

开关选项

可选模型

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

功能特性说明：

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

模型选择建议

快捷工具栏

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

按钮功能说明

详细用法

○ 添加上下文

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

@ 引用功能

常用的引用方式：

🌐 Web 搜索

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

🖼️ 图片上传

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

🎤 语音输入

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

Web 搜索功能

搜索选项

选项区别

🔴 Off（关闭）

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

🟢 Browser Tab（内置浏览器）

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

🟢 Google Chrome（外部浏览器）

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

使用建议

引用功能详解

@Browser

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

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

其他 @ 功能对比

快捷键大全

Chat 相关快捷键

代码选择与上下文

内联编辑快捷键

Tab 代码补全快捷键

终端快捷键

使用建议

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 测试和信息收集