目录

一、介绍

二、如何打开文件

1、从idea跳转文件

 2、单独打开项目

三、常见使用

1、Chat 窗口 Ask 对话模式

1.1、使用技巧

 1.2 发送和使用 codebase 发送区别

1.3、问题快速修复

2、Chat 窗口 Agent 对话模式

2.1、agent模式功能

2.2、Chat 窗口回滚&撤销

2.3、使用技巧

3、智能编码

（1）基础示例

（2）文档模板补全

（3）变量和函数补全

（4）方法和属性补全

4、内联聊天

5、代码库索引

5.1、介绍

5.2、如何配置代码库索引

6、常用 @ 命令讲解

7、AI 生成提交消息

8、自定义 AI 规则

（1）项目级规则（推荐）

（2）全局规则

9、Agent+Yolo 模式

10、MCP

 ​编辑

---

一、介绍

Cursor - The AI Code Editor

下载安装后使用google账户登录。

二、如何打开文件

1、从idea跳转文件

switch2Curson可以实现Idea和Cursor同行跳转的插件

如我打开一个工程，点击Open File In Cursor

点击跳转后，让AI自动加上一个字段 

 2、单独打开项目

可以像vs code那样单独打开一个项目

三、常见使用

1、Chat 窗口 Ask 对话模式

分为 Ask、Manual、Agent 三种对话模式。统一在一个窗口的好处是，如果 Ask 模式讨论的内容，可以方便的切换为 Agent 模式直接将内容写到文件中。

Ask 模式是 Cursor 中最基础的 AI 交互方式，主要用于帮助你理解和探索代码。它可以：

• 回答你关于代码的各种问题

• 帮助搜索和理解代码库

• 提供代码解释和建议

• 快速修复代码错误（通过 AI Fix 功能）

• 和 Agent 模式最大区别是不能自动生成文件，如果是代码片段需要手动 Apply

如：可以看到，ask模式下并没有自动操作代码，agent模式下则自动删除了

1.1、使用技巧

• 使用 ⌘ + L 快速打开/关闭 Chat 窗口，并自动切换到 Ask 模式

• 通过 @ 符号添加特定上下文

• 悬停在代码错误上方，点击 AI Fix 按钮快速修复问题

 1.2 发送和使用 codebase 发送区别

在 Chat 窗口下，发送消息此前是两个提交按钮，现在只展示了一个按钮，如果不看文档，你都不知道它这里竟然还有隐藏功能：

1. ↵：

   • 直接按回车或点击发送按钮

   • 普通提交，只发送当前的对话内容

   • 适合简单的问题咨询和代码讨论

   • 不会包含项目上下文信息

2. ⌘↵：

   • 按住 ⌘（command） + ↵（回车） 键发送

   • 带有代码库上下文的发送

   • 会自动分析并包含相关的代码文件内容

   • 适合需要 AI 理解当前项目结构和代码的场景

   • 能得到更准确的回答，因为 AI 有更多上下文信息

1.3、问题快速修复

Cursor 提供了便捷的代码错误修复功能。当代码出现错误时，你可以：

1. 鼠标悬停在错误处

2. 把错误信息发送给 Cursor Chat 窗口

3. AI 会分析错误原因并给出修复建议

注意，按下 ⌘ 键再点击错误信息，会发送错误信息到新 Chat 窗口。原先底部的 Ask 模式会被切换为 Agent 模式。

2、Chat 窗口 Agent 对话模式

Agent 模式是 Cursor 默认的对话模式，也是一个更强大的 AI 编程助手，专注于代码的创作和修改。它不仅能理解代码，还能直接进行文件操作。

2.1、agent模式功能

Agent 模式是 Chat 窗口中最强大的功能，它像一个真实的编程助手，可以主动帮你完成各种复杂的编程任务：

• 自动获取相关上下文

• 执行文件创建、修改、删除操作

• 运行终端命令（需要开启 Yolo 模式）

• 自动代码库搜索（Codebase 功能）

• 执行过程中如果发现错误，会尝试自动修复错误

• 呼叫 MCP 功能，只有在 Agent 模式下能使用

• 自动进行网络搜索

Agent 的工作流程：

1. 主动行为：

   • 自动分析项目结构

   • 提出具体解决方案

   • 创建必要的文件

2. 文件操作：

   • 创建新文件

   • 自动导入依赖

   • 添加相关功能

3. 终端集成：

   • 提示运行命令

   • 展示执行结果

   • 所有命令都会先征求你的同意（前提是 Yolo 模式为关闭状态）

4. 智能搜索：

   • 自动找到相关文件

   • 分析代码依赖关系

   • 提供相关代码建议

5. 上下文管理：

   • 自动包含相关文件内容

   • 理解代码之间的关联

   • 保持代码风格一致

6. 错误自动修复：

   • 执行期间的错误自动修复

   • 支持将错误信息直接添加到 Chat 中进行修复

2.2、Chat 窗口回滚&撤销

在 Chat 窗口中，右下角有一个 Restore 按钮，可以回滚到之前的版本。在回滚之后，还可以使用撤销按钮，撤销回滚。

推荐及时通过 Git 的版本控制来管理代码的每次主要变更。

2.3、使用技巧

• 使用 ⌘ + I 打开 Chat 窗口 Agent 模式

• 使用 ⌘ + N 创建新的 Chat 会话（需要在 Chat 窗口中）

• 使用 ⌘ + . 切换 Ask/Edit/Agent 模式

• 通过 @ 符号添加特定上下文

• 使用检查点（Checkpoints）功能随时回退更改

• 只是提问问题，建议 Ask 模式

• 需要执行任务，建议 Agent 模式

3、智能编码

（1）基础示例

当我们输入一段文本时，Cursor 会根据上下文提供智能补全建议。只需按下 Tab 键，就可以接受建议并继续写作。

代码智能补全是 Cursor 最强大的功能之一，它不仅能提供基本的代码补全，还能理解代码上下文，给出最合适的建议。

（2）文档模板补全

1. API 文档补全

   • 输入 "## API" 时，会提供 API 文档模板

   • 自动生成标准的 API 文档结构

• 错误处理文档补全

  • 输入 "## 错误" 时，自动补全错误处理文档结构

  • 帮助快速创建标准化的错误文档

（3）变量和函数补全

当你开始输入变量或函数名时，Cursor 会根据上下文提供智能建议：

// 1. 变量名补全

const userName = '张三';

// 输入 "user" 时，Cursor 会建议：

userName // 已定义的变量

userId // 常见的相关变量

userEmail // 上下文相关的建议

// 2. 函数名补全

function calculateTotalPrice(price, quantity) {

return price * quantity;

}

// 输入 "calc" 时，Cursor 会建议：

calculateTotalPrice // 已定义的函数

calculateDiscount // 相关的函数名

calculateTax // 上下文相关的建议

（4）方法和属性补全

输入对象后的点号时，Cursor 会显示所有可用的方法和属性：

• 字符串方法补全

• 数组方法补全

• 对象属性补全

4、内联聊天

在日常开发中，我们经常需要编写新代码、修改已有代码或执行终端命令。Cursor 提供了强大的内联聊天功能，可以帮助你快速完成这些任务。

在 Cursor 中，你可以使用以下快捷键打开命令输入栏（Prompt Bar）：

• macOS：Cmd K

• Windows/Linux：Ctrl K

命令唤醒的输入栏，也是一个 AI 聊天窗口，不过它不是一个单独的窗口，而是内联在文件中，主要功能包括：

• 输入自然语言描述来提问

• 使用 @ 符号引用其他内容

• 对生成的结果进行多次优化

5、代码库索引

代码库索引是 Cursor 最强大的功能之一。它通过为代码文件创建嵌入向量（Embeddings），帮助 AI 全面理解你的项目。这个功能让 AI 能够"看见"整个代码库，而不仅仅是当前打开的文件。

5.1、介绍

使用代码库索引后：

• ✅ AI 回答更准确，因为它能基于当前项目的索引库回答问题

• ✅ 文件搜索更快

• ✅ AI 能更好地理解跨文件的关系

• ✅ 重构建议更精准

实际效果对比

使用代码库索引和不使用代码库索引的主要区别：

• 使用代码库索引时，AI 先搜索了项目中的文件，然后根据文件内容回答

• AI 能准确指出项目中实现的具体功能和代码

• 不使用代码库索引时，AI 只能从一般角度回答，没有针对项目的具体情况

5.2、如何配置代码库索引

基本设置

Cursor 默认会自动索引新打开的文件夹。设置步骤：

1. 打开Cursor Settings

2. 进入 Indexing & docs

3. 查看同步状态指示条（显示索引进度）

4. 可用操作：

   • 【Sync】重新同步索引

   • 【Delete Index】删除现有索引

重要配置选项

1. 自动索引新文件夹

   • Index new folders by default选项默认开启

   • 自动索引新打开的文件夹

   • 超过 250,000 个文件的文件夹不会自动索引

2. 忽略文件设置

   • Ignore files选项用于配置索引时要忽略的文件

   • 这些规则会补充.gitignore中的规则

   • 可以通过Configure ignored files按钮设置规则

   • 或创建.cursorignore文件配置规则

最佳实践

为了更好地使用代码库索引功能：

1. 定期检查索引状态（通过进度条）

2. 合理设置忽略规则，避免索引无关文件

3. 大型项目考虑模块化索引

4. 团队统一.cursorignore配置

5. 使用代码库索引功能快速理解项目

常见问题解决

索引不同步或失败问题

• 点击Delete Index删除索引，然后重新打开项目

• 或者点击Sync Index重新同步

• 索引被删除时，需要点击"Compute Index"重新计算

索引进度条卡住

如果索引进度条卡住（一直显示 Pause Indexing）：

• 确认网络是否正常

• 尝试删除索引，重新计算

代码安全问题

关于代码安全，Cursor 的隐私政策说明：

• 代码会分成小块上传到服务器计算嵌入向量

• 所有明文代码在请求完成后立即删除

• 只有嵌入向量和元数据（如哈希值、文件名）会存储在数据库中

• 源代码本身不会被保存

6、常用 @ 命令讲解

在 Cursor 中，@ 命令是一个很有用的工具。你在 Chat 窗口输入 @ 时，就可以看到很多选项。

你可以这样使用 @ 命令：

1. 在输入框中输入 @

2. 用上下键选择你想要的命令

3. 按 Enter 键确认

 常用的@命令

@Files和@Folder - 引用文件和文件夹

这两个是最常用的@命令，可以引用项目中的特定文件和文件夹作为上下文。如果要引用文件，直接将文件或文件夹拖拽到 Chat 窗口会更方便。

@Code - 引用代码片段

如果要引用代码片段，最方便的方式是在编辑器中选择代码，然后按Command + 添加到Chat 窗口。相比使用@Code命令，这种方式更直观，也更方便。

@Docs - 访问文档

例如，我们要写一个 Next.js 项目，需要参考 Next.js 的官方文档，我们可以将官方文档添加到 Cursor 中，然后通过@Docs命令访问。

Cursor 会自动抓取和索引第三方文档，你还可以通过 Cursor 设置 -> Features -> @Docs -> Add new doc 添加自定义文档。

@Git - 访问Git历史

访问项目的Git历史和变更记录。当你不清楚过去某个版本改过了什么，通过@Git命令可以让 AI 根据 Git 历史和变更记录回答你的问题。

在 Chat 窗口输入 @Git 后选择某个 Git 历史版本。

@Cursor Rules

访问为项目设置的规则和指南，并将其应用于上下文。在 Chat 窗口输入 @Cursor rules 后选择某个规则。只支持在 Agent 模式下，正常 Agent 模式会根据匹配的规则自动应用。

@Web - 引用外部资源

@Web 命令会自动搜索互联网以查找与 Cursor 查询相关的上下文。在 Agent 模式下，必要时会自动执行 @Web 命令。

例如，我们提问一些问题，如果想让 Cursor 查询最新内容进行回答，可以输入 @Web 命令。Cursor 会根据问题自动搜索互联网，并根据搜索结果进行回答。

@Past chats - 引用历史对话

@Past chats 命令会显示你之前与 Cursor 的对话记录。意思就是你可以将某次对话记录作为上下文引用。这个是最近刚推出的一个功能。

其它@命令

• @Recent Changes：查看最近更改，创建指向特定代码或文档的链接

• @Lint Errors：Agent 模式下，会根据 Lint 错误自动修复

其他符号

• # Files - 添加文件到上下文而不引用

• / Commands - 添加打开和活动的文件到上下文

7、AI 生成提交消息

在日常开发中，编写清晰、规范的 Git 提交消息常常是一项耗时且有挑战的任务。Cursor 提供的 AI 生成提交消息功能可以帮助开发者快速创建高质量的提交记录，大大提高工作效率。这个功能特别实用，让我们不再需要花费大量时间思考如何描述代码变更。

使用 Cursor 的 AI 生成提交消息功能非常简单：

1. 完成代码修改后，打开源代码管理面板

2. 在提交消息输入框中，点击右侧的闪光图标 (✨)，AI 会自动生成提交消息

3. AI 会根据你的代码变更生成合适的提交消息，你可以直接点击 Commit 按钮提交

4. 提交后，点击 Sync 按钮将代码推送到远程仓库

在 SOURCE CONTROL GRAPH 面板中，你可以查看所有提交记录，点击任意提交记录可以查看具体的代码变更。

8、自定义 AI 规则

什么是 AI 规则？

AI 规则是 Cursor 的一个功能。你可以用它来控制 AI 的行为。这些规则会在每次对话时自动使用。这样 AI 就能按照你想要的方式工作。

主要用途有：

• 设定编码风格

• 定制文档格式

• 统一团队流程（团队协作特别适用）

• 个性化代码审查

规则设置方式

Cursor 目前项目级规则优先级最高，推荐使用项目级规则：

• 项目级规则

• 全局规则

（1）项目级规则（推荐）

你需要在项目根目录的 .cursor/rules 文件夹中创建 .mdc 文件。mdc 是 Cursor 的规则文件格式。它基于 Markdown 格式。它支持四种规则类型:

1. Always：自动附加到所有聊天和命令请求（command + k），适用于全局规则

2. Auto Attached：基于文件模式匹配自动触发，例如: .tsx, .json, Test.cpp

3. Agent Requested：针对特定任务场景，需要提供任务描述。帮助 AI Agent 更好地理解和执行特定任务

4. Manual：需要手动提及才会被包含，适用于特殊场景的临时规则

支持的功能：

• 规则内容：用 Markdown 格式写规则

• 规则引用：用 @file 引用其他规则文件

创建方法：

1. 方法一：

   • 打开命令面板（⌘+⇧+P）

   • 选择 "New Cursor Rule"

   • 输入规则文件名

   • 在打开的 .mdc 文件中写规则

2. 方法二：

   • 在 Cursor 设置中，找到 Rules 选项

   • 点击 "+ Add new rule" 按钮

（2）全局规则

全局规则对所有项目都有效。设置步骤：

1. 打开 Cursor 设置

2. 进入 "Rules" → "User Rules"

3. 添加全局规则（如语言设置）

9、Agent+Yolo 模式

在前面我们介绍了 Cursor 的 Agent 模式，它像一个真实的编程助手，可以主动帮你完成各种复杂的编程任务。现在，让我们来了解一下 Cursor 在 0.44 版本中新增的 Yolo 模式。

Yolo 模式是一个让 Agent 更加自动化的功能。之前介绍的 Agent 模式，Agent 会根据你的提示，判断是否需要执行命令，如果需要执行命令，会提示你确认。

Yolo 模式则更进一步，Agent 将无需确认就能执行命令和文件操作，朝着"全自动驾驶"又迈进了一步。开启 Yolo 模式后，Cursor 编辑器能够：

• 文件的增删改查控制权利更大

• 执行代码所需的命令

• 修复可能出现的问题

• 重复执行这些操作

而你只需要留意它正在做什么就可以了。

如何启用 Yolo 模式？

1. 打开 Cursor 设置

2. 进入 Chat 部分

3. 找到并启用 Auto Run Mode选项

在启动 Yolo 模式后，你可以配置以下选项：

• Auto-run prompt：描述哪些命令应自动执行，由模型判断。例如："仅限编译命令、git 命令和其他安全命令"

• Command allowlist：如果只有特定命令应自动执行，可以在此添加

• Command denylist：永远不应自动执行的命令

• File-Deletion protection：如果启用，将阻止 Agent 自动删除文件

• MCP tools protection：如果启用，将阻止 Agent 使用 MCP 工具

Command denylist 这个选项，建议配置 rm 命令，防止误删文件。但是，还是要注意，开启 Yolo 模式后，建议及时使用 git 提交代码，防止误删后找不回来。在企业级项目中，建议不要开启 Yolo 模式。

10、MCP

Cursor 里面有 MCP，所以 AI 助手可以：

1. 读写你电脑上的文件

2. 搜索网络信息

3. 运行命令

4. 使用数据库

5. 使用各种工具

这样 AI 助手就不只是看懂你的代码，还能帮你做很多事情。

 

1. 用配置文件

MCP 用 JSON 文件来设置，有两种设置：

1. 所有项目都能用的设置

   • 文件位置：~/.cursor/mcp.json

   • 用途：你想在所有项目中都用的 MCP 服务器

   • 这些工具在所有 Cursor 项目中都能用

2. 单个项目的设置

   • 文件位置：项目里的 .cursor/mcp.json

   • 用途：只给这个项目用的 MCP 服务器

   • 这些工具只在这个项目里能用

配置文件示例：

{"mcpServers": {"server-name": {"command": "npx","args": ["-y", "mcp-server"],"env": {"API_KEY": "your-api-key"}}}
}

配置说明：

• command：运行服务器的命令

• args：命令行参数

• env：环境变量，用于存储 API 密钥等敏感信息

使用Playwright MCP

Playwright MCP 服务器提供了浏览器自动化能力，让 AI 能够直接操作网页、截图和执行 JavaScript。这使得 AI 助手能够帮助我们进行网页测试、数据抓取等任务。

主要功能：

1. 浏览器自动化

   • 控制真实浏览器进行网页交互

   • 支持多种浏览器（Chrome、Firefox、Safari）

   • 可执行点击、输入、滚动等操作

2. 网页截图

   • 捕获整个页面或特定元素的截图

   • 支持多种图片格式

3. JavaScript 执行

   • 在页面上下文中执行 JavaScript 代码

   • 获取页面元素和数据

设置方法：

{"mcpServers": {"playwright": {"command": "npx","args": ["-y", "@playwright/mcp@latest"]}}
}

MCP 学习资源

1. Github 上有个 servers 仓库，里面有很多 MCP 服务器的代码

2. 访问 MCP 官网文档 了解更多关于该协议的内容

3. MCP 客户端有很多，Cursor 只是其中一个