大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



文章已经收录到 GitHub 个人博客项目，欢迎 Star：

或者访问网站，进行在线浏览：

1.1 概述

Cursor 是一款功能强大的 AI 优先代码编辑器，可增强开发工作流程。

主要提供三个核心方向：

• 深度集成 AI 模型，不是简单地接入模型，而是让 AI 充当了编译器的核心交互方式。支持代码块对话、项目级对话、模型自由选择。
• 强上下文理解能力，可以自动识别项目文件、代码块、错误信息等等，提供更直观准确的 AI 修改能力。
• 对话式开发体验，仅需用自然语言沟通，Cursor 就会根据指令完成布置的任务，使用者可以轻松扮演产品经理，让 Cursor 理解你的命令自行工作。

关注微信公众号：【Java 陈序员】，获取开源项目分享、AI 副业分享、超 200 本经典计算机电子书籍等。

对比其他编辑工具来说：

• 对比 VS Code：基于 Visual Studio Code 打造而成的 AI 编程工具，因此界面和基础操作与 VS Code 高度相似，无缝衔接
• 对比 JetBrains IDEA：Cursor 提供 AI 驱动的现代编码体验，可以取代 JetBrains IDE，JetBrains 程序员可能会感觉不同

1.2 安装使用

1.2.1 安装

1、访问 Cursor 官网并单击下载按钮

2、运行安装程序并等待安装完成

3、通过桌面快捷方式或从应用菜单启动 Cursor

1.2.2 登录

1、点击注册或登录后，系统会提示您设置一个帐户。可以选择使用邮件，或者使用 Google 或 GitHub 账号登录。

如果第一次使用 Cursor，将获得 14 天的免费试用期。

2、登录后，送回 Cursor，然后就可以开始编码了。

1.2.3 无限续杯

新注册的 Cursor 用户有着 14 天免费，50 次免费高级提问的额度，但是也很轻易就会达到上限。

Cursor 会通过检测用户的邮箱账号以及电脑的机器码进行识别，我们出于学习的意图，可以尝试在达到上限后绕过这些限制继续学习。

推荐进行付费使用，功能也会更强大！

• 准备新邮箱

可以去 2925 邮箱注册一个账号，这个邮箱平台的一个优势是用户申请的邮箱之后，可以自行创建子邮箱。

比如，创建了 这个邮箱，那么我们在 Cursor 申请账号的时候，可以使用 、、 等邮箱进行注册（也就是 CodeChen数字随意@2925.com），当使用这些子邮箱注册时，会在主邮箱中收到邮件，这样就可以无限制创建和使用邮箱。

2925 邮箱注册地址：

• 机器码识别激活成功教程

Cursor 的团队意识到了开发者会通过换邮箱的方式投机取巧，于是加入了校验本机机器码的环节。即使用户注册了一个新的邮箱，但是机器码所属的额度用完之后，也是不能继续免费了。

俗话说，你有张良计，我有过墙梯。有个开源项目 针对 Cursor 的机器码识别问题，提供了重置机器码和快速注册新账号等功能。

1、下载

2、鼠标右键以管理员身份运行

3、输入 1，重置机器 ID

4、输入 2，自动在浏览器中打开 Cursor 注册页面，使用新邮箱重新注册

5、注册成功后，在 Cursor 中登录新账号

1.3 Cursor 设置

在 Cursor 中，具有 Cursor Settings 和 Editor Settings 两个不同的配置入口，分别用于管理 AI 功能 和 编辑器基础设置。

二者的区别如下：

1.3.1 Cursor AI 配置

在 Cursor 中可通过页面右上角的设置按钮（齿轮图标）或者使用快捷键 打开 AI 设置。

以下是对 Cursor Settings 中各项配置的作用解释（不同版本的配置可能会不一样，但是都大同小异）：

• General（常规）：包含账户管理设置，进行登录、注册操作，实现配置在不同设备间的同步；支持一键迁移 VS Code 配置，快速迁移主题、快捷键等设置；还包括隐私配置管理。
• Chat（对话模式）：配置对话模式（Ask、Edit、Agent）的核心功能，对相关参数进行微调，比如调整代码补全的触发灵敏度、对话模式的快捷操作设置等。
• Tab（智能助手）：配置 Tab（智能助手）的核心功能。
• Models（模型）：允许用户选择不同的 AI 模型（有多个可用选项）；同时支持添加模型和配置模型访问的 API Key 等。
• Tools（工具） & Integrations（集成）：配置 Github、Slack 的集成，加强 AI 上下文关联；同时支持配置自定义的 MCP 服务。
• Rules（规则） & Memories（记忆）：配置制定代码检查规则，用来约束或指导 AI 的行为，如对 AI 生成的代码格式、语法规范等进行约束；以及配置记忆功能，记忆是在 AI 与你的对话过程中自动或手动记录的重要信息。
• Indexing（索引） & Docs（文档）：定义需要被索引的代码库路径，让 Cursor 的 AI 能理解代码上下文；配置文档地址，将第三方框架文档设置为上下文，AI 可以结合文档内容，给出更准确的解答和建议。
• Beta（测试版）：可启用或禁用测试功能，提供反馈等。用户能通过这里尝试 Cursor 的新功能，并帮助开发团队测试和改进这些尚未正式发布的特性 。

1.3.2 Cursor 编辑器配置

使用快捷键 打开控制面板，输入 .

编辑器设置和 VS Code 的设置界面一致。

在 Cursor 编辑器设置中，“User” 和 “Workspace” 存在以下差异：

User（用户）

• 作用范围：User 设置是全局性的，应用于当前登录用户在所有工作空间中的操作。无论打开哪个项目或工作空间，这些设置都始终生效。
• 数据存储：User 设置存储在用户的配置文件中，与特定项目无关。当在不同设备上登录同一账号时，User 设置会同步，保证一致的使用体验。

Workspace（工作空间）

• 作用范围：Workspace 设置仅在特定的工作空间（一般对应一个项目文件夹 ）内有效。不同的工作空间可以有各自独立的设置，互不影响。
• 数据存储：Workspace 设置存储在工作空间根目录下的 文件夹（Cursor 基于 VS Code，沿用类似结构）中，仅在该工作空间打开时生效。

1.3.3 Cursor 汉化

Cursor 汉化步骤如下：

1. 打开扩展：启动 Cursor 后，使用快捷键 ，左侧边栏会出现扩展商店界面。
2. 搜索并安装插件：在搜索框输入Chinese或中文，一般选择下载量最高的Chinese (Simplified) Language Pack for Visual Studio Code，点击安装按钮进行安装。
3. 打开命令面板：按下 ，输入 Configure Display Language 并回车，进入语言配置界面。
4. 选择中文并重启：在弹出的语言列表中选择 “中文（简体）” 或 “zh-cn” ，保存设置后重启 Cursor.
5. 重启 Cursor：此时界面将完全切换为中文，包括菜单、提示信息和设置选项。

1.4 迁移 VS Code 配置

Cursor 基于 VS Code 设计打造，如之前已经使用过 VS Code, 可将其中的配置迁移至 Cursor 中。

1.4.1 一键导入

Curson 提供一键导入 VS Code 配置的功能，可以将当前电脑中 VS Code 的 Extensions 扩展、Themes 主题、Settings 设置、Keybindings 键绑定等配置导入到 Cursor 中。

在最新版的 Cursor 一开始安装中，可设置是否导入 VS Code 配置。

VS Code 的配置文件默认位置为：

• Window 系统：导入的是 路径下的 配置文件
• MacOS 系统：导入的是 路径下的配置内容
• Linux 系统: 导入的是 路径下的配置文件

注意：并非所有 VS Code 扩展都与 Cursor 兼容。一些依赖 VS Code 特定 API 的插件，在导入时可能导致整个导入过程失败或部分功能（如主题显示）异常。

如在安装 Cursor 时未设置导入 VS Code 配置，可通过如下方式手动导入：

1. 打开 Cursor 设置中心（）
2. 导航到 General（常规） –> Preferences（首选项）
3. 在 Importing Setiings from VS Code（从 VS Code 导入设置） 下，单击 Import（导入） 按钮

1.4.2 手动迁移

如果是在不同电脑的配置，或者希望对设置进行更多控制，可以手动迁移配置文件。

• 导出配置文件

1. 在 VS Code 中，打开命令面板（）
2. 输入 Preferences： Open Profiles （UI）
3. 在左侧边栏上找到要导出的个人资料
4. 单击 ··· 图标并选择 Export Profile
5. 输入文件名称并回车
6. 选择将其导出到本地文件或 GitHub Gist

• 导入配置文件

7. 在 Cursor 实例上，打开设置中心（）
8. 搜索 Preferences： Open Profiles （UI）
9. 单击 New Profile 旁边的下拉菜单，然后单击 Import Profile
10. 粘贴 GitHub Gist 的 URL 或选择选择文件以上传本地文件
11. 单击对话框底部的 Import 以保存配置文件
12. 最后，在侧边栏中，选择新的配置文件，然后单击勾号图标将其激活

1.5 配置 Java 语言环境

在 Cursor 中进行 Java 开发，需要配置 JDK、Maven 等环境，同时需要安装插件，才能调试、运行 Java 应用程序。

1.5.1 配置本地 JDK 和 Maven 配置

• 自动读取情况

如果在系统环境变量中正确配置了 和 ，且环境变量配置无误（变量值准确指向 JDK 和 Maven 的安装目录 ），部分情况下 Cursor 能自动识别并应用这些配置。

比如，当你在 Cursor 中创建、运行或调试 Java 项目时，它可能会利用自动读取到的环境变量来找到对应的 JDK 和 Maven 位置，完成代码编译、项目构建等操作。

• 手动配置情况

如果 Cursor 没有自动读取到 JDK 和 Maven 配置，就需要手动配置，步骤如下：

1、在 Cursor 输入快捷键 打开命令面板 2、输入 Preferences: Open User Settings (JSON) 并回车，打开 文件 3、然后添加或修改以下内容：

保存文件后，重启 Cursor 使配置生效。

1.5.2 安装 Java 环境相关插件

在 Cursor 中使用 Java 开发，即使已安装 JDK 和 Maven 并配置好环境变量，仍需安装 Java 扩展插件以获得完整的开发体验。这些插件能将编辑器（如 Cursor/VS Code）从普通文本编辑器转变为智能 IDE，提供语法高亮、代码补全、错误提示、调试支持、Maven 项目管理等核心功能。

在 Cursor 中，使用快捷键 打开插件，安装插件 Extension Pack for Java.

这是一个插件集合，而非具体单个插件。它集成了多个与 Java 开发相关的插件，安装后能为开发者在 Visual Studio Code 或 Cursor 等编辑器中提供完整的 Java 开发环境，涵盖从代码编写、调试、测试到项目管理等多方面功能。

注意：选择由 Microsoft 发布的扩展包，并安装。

插件集合中包含如下插件：

• Language Support for Java™ by Red Hat

提供语法高亮、智能代码补全、代码检查、代码格式化（）、代码导航以及重构支持等功能，辅助高效编写和优化 Java 代码。

• Debugger for Java

实现轻量级 Java 程序调试，可设置断点，调试时查看变量值、对象属性和调用栈，追踪程序执行流程以排查问题。

• Maven for Java

用于管理 Maven 项目，能创建新项目，管理项目依赖，执行 Maven 构建任务，如清理、编译、打包项目等。

• Test Runner for Java

支持 JUnit 和 TestNG 等测试框架，方便运行和调试 Java 测试用例，展示测试结果及详细日志，助力开发者定位问题。

• Project Manager for Java

可在编辑器中管理多个 Java 项目，实现快速切换，导入本地 Java 项目，可视化展示项目模块、包和文件结构。

• Gradle for Java

针对 Gradle 构建工具，能创建 Gradle 项目，运行 Gradle 任务，管理项目构建、测试流程，查看 Gradle 任务和工程依赖。

1.6 IDEA 中使用 Cursor

如果习惯于使用 IDEA 进行 Java 应用开发，又想借助 Cursor 的 AI 编程能力，可通过如下两款插件进行二者之间的切换。

• Switch2Cursor

顾名思义，这是一款 IDEA 插件，帮助开发者从 IDEA 跳转到 Cursor 编辑器。

1. 环境要求：已安装 Cursor、IDEA 2022.3 及以上版本
2. 安装：在 IDEA 的插件市场搜索 switch2cursor 进行安装
3. 配置 Cursor 路径：在 IDEA 中打开 配置 Cursor Path 为你的 Cursor 可执行文件的路径，如： 需要替换成自己电脑的 Cursor 安装路径
4. 使用快捷键切换到 Cursor：

• 打开项目：
• 打开当前文件：

• Switch2IDEA

顾名思义，这是一款 Cursor 插件，帮助开发者从 Cursor 跳转到 IDEA 编辑器。

1. 安装：在 Cursor 扩展市场中搜索 “Switch2IDEA” 并安装
2. 配置 IDEA 路径：打开 Cursor 设置，点击 G
3. 配置 IDEA 安装路径
4. 使用快捷键切换到 IDEA：

• 打开项目：
• 打开当前文件：

2.1 Tab 键：代码自动补全

Cursor 的 Tab 键具有强大的代码自动补全功能，基于 AI 模型，能根据代码上下文自动预测并生成代码补全建议和代码修复重构，还可用于代码自动联想等。

使用方式：使用 键接受建议， 键拒绝建议， 逐字部分接受建议（部分接受功能需要启用 Partial Accepts 配置项）。

2.1.1 单行/多行代码补全

• 新建一个工具类，在类中写上注释计算数组平均值

• 按 键，Cursor 自动生成代码

2.1.2 智能代码重写

• 已有代码如下：

• 使用 Stream 重构 方法，按 键，自动补全：

2.1.3 自动联想

新建一个 POJO 类，输入几个变量后，Cursor 会自动联想，使用 键快速生成代码。

2.1.4 Tab 相关配置

Tab 相关配置修改位置：.

• Cursor Tab：启用/禁用 Tab 功能。相当于“总开关”，启用后才能用 Tab 键触发 AI 代码建议（如多行补全、智能续写）；取消勾选则 Tab 仅作普通缩进。
• Partial Accepts：部分建议功能，启用后，可使用 逐个单词接受 AI 建议。比如 AI 建议 ，但你只想用 部分，就可通过该快捷键拆分接受。
• Suggestions While Commenting：控制是否在注释里也提供 Tab 建议。写注释时，Tab 键同样会帮你补全思路。如输入 ，按 Tab 自动续写步骤说明。
• Whitespace Only Suggestions：控制是否显示仅包含空白（空格、换行、格式化代码）的 AI 建议。这个配置项决定了当按 Tab 时，是否让那些只调整空格、换行、缩进（没有实际代码逻辑变化）的建议显示出来。

比如，如下代码格式不齐整：

1. 勾选：把光标放在混乱的代码里（比如 这行后面） Tab 会有修改建议
2. 不勾选：把光标放在混乱的代码里（比如 这行后面） Tab 不会有修改建议

• Imports：在 TypeScript 中，写代码时缺模块，按 Tab 键自动帮你导入模块依赖。
• Auto Import for Python：为 Python 开启导包功能（测试版），按 Tab 键自动导入缺失模块。

2.2 Chat: 对话模式

Chat（之前称Composer）是 Cursor 的 AI 助手，位于编辑器的侧边栏中，通过自然语言与代码库进行交互。

可以提出问题、请求代码编辑、获取终端命令建议等。

Cursor Chat 主要功能：

• Chat 能够了解代码库并对其进行更改，这是实现新功能、新需求的强大方法
• Chat 通过深入了解代码库以及每个组件如何组合在一起，帮助你重构代码库
• Chat 可以根据输入的需求，从零开始进行项目搭建，包括创建项目结构、安装依赖项、甚至编写初始代码等，尽快开始业务编码
• Chat 也可以根据当前项目的错误信息，进行错误定位和错误代码直接调整解决

2.2.1 快速开始

使用 打开侧边栏中的聊天窗口，用中文文字输入请求，Cursor 将做出相应的响应。

注意：与 Chat 对话时，建议采用清晰、具体的语言格式，最好包含任务类型、上下文描述和具体要求。

以下是几个参考模板：

• 代码生成类

示例：

• 代码修改类

示例：

• 代码解释类

示例：

• 流程自动化类

示例：

• 命令行辅助类

示例：

提示词技巧总结：

1. 提供上下文：提及项目语言、框架、业务背景等信息
2. 分点描述：将复杂需求拆解为具体步骤或要求
3. 使用技术术语：准确的术语能帮助 AI 更精准理解需求
4. 明确边界：说明必须保留的现有功能或禁止的实现方式
5. 示例引导：附上期望输出示例或参考代码风格

2.2.2 Chat 三种模式

Chat 提供针对特定任务优化的不同模式：

1. Agent 代理模式（默认）: 全能模式，可以自主调用所有的 Search、Edit、Run 工具。它会主动规划任务、修改代码、运行命令，甚至在出错时自我修复。
2. Ask 对话模式：智能问答模式，可以自主调用所有 Search 工具，但不能编辑文件或运行终端命令。会根据你的问题，在代码库和网络中寻找答案，并以文本或代码块形式回复。
3. Manual 手动模式：纯手动模式，几乎不自主调用任何工具。它的行为完全由你的指令驱动，比如你用 @ 指令明确提供了哪个文件，它才会去读哪个文件。它更加可控，适合执行精准、小范围的修改任务。

2.2.2.1 Agent 模式

Agent 是 Cursor 中的默认且最自主的模式，旨在以最少的指导处理复杂的编码任务。它启用了所有工具，可以自主探索代码库、阅读文档、联网搜索、编辑文件和运行终端命令以高效完成任务。

Agent 的能力总结：

• 独立探索项目代码，识别相关文件，并进行必要的更改
• 使用所有可用工具搜索、编辑、创建文件和运行终端命令
• 全面了解项目结构和依赖关系
• 将复杂任务分解为可管理的步骤并按顺序执行

生成和修改示例：

1、新建一个文件夹，并在 Cursor 中打开

2、使用 打开对话模式（默认 Agent 模式）

3、输入用例对话

4、发送需求，并等待生成代码

5、运行代码对话

6、后续进行对话，进行代码调整或者添加新需求

Agent 的配置选项：

• Model（模型选择）：选择使用哪种大模型
• Keybindings（快捷键设置）： 为 Agent 模式设置快速开启快捷键（默认 ）
• Auto-run（自动运行）：当你让 Agent 修改代码后，自动执行相关命令（如编译、测试、运行），验证修改的正确性
• Auto-fix errors（自动修复）：当自动运行过程中出现错误（如编译失败、测试报错），Agent 会尝试分析错误信息并自动修复

错误调试和修改示例：

1、准备错误信息类

2、运行时出现如下报错信息

3、对话解决错误信息：选中错误信息，使用快捷键打开 Chat 模式，输入描述【根据错误信息，解决程序Bug】

2.2.2.2 Ask 模式

Ask 是 Chat 的只读模式，用于提出问题、探索和了解代码库。

Ask 是其他模式（Agent 和 Manual）所独有的，因为它默认不自动应用任何建议的更改，这使它成为一种只读模式，具有读取文件和其他上下文的完整能力，但不能自行进行任何更改。

适合在不想更改代码库或在实施之前使用 AI 规划解决方案的场景下使用。

如在 Ask 模式下给贪吃蛇添加多种游戏模式：

Ask 的配置选项：

• Model（模型选择）: 选择使用哪种大模型
• Keybindings（快捷键设置）：为 Ask 模式设置快速开启快捷键
• Search codebase（搜索代码库）: 是否允许 Cursor 搜索代码上下文，不需要手动 作为上下文

2.2.2.3 Manual 模式

与 Ask 模式不同，Manual 模式不探索代码库或运行终端命令。

完全取决于具体说明和提供的上下文（例如，通过 ），AI 生成修改建议后，还需要用户手动点击应用才会改动代码，而且通常是单文件/局部代码调整。

如给代码添加注释：

Manual 的配置选项：

2.2.3 Chat 模式的其他细节

2.2.3.1 代码编辑选项

当 Chat 建议更改代码时：

1、Review changes：在差异视图中查看建议的更改

2、Apply: 在Ask/Manual 模式下，使用应用按钮显式应用更改

3、Accept/Reject（接受/拒绝）：进行更改后，决定是保留还是放弃更改

3.2.3.2 Checkpoints 数据还原

有些情况，需要恢复到代码库的先前状态。Cursor 通过在发出的每个请求以及每次 AI 更改的代码库时自动创建代码库的检查点（Checkpoints）来帮助解决这个问题，类似于 Git 版本管理中的回滚操作。

要恢复到之前的状态，可以：单击上一个请求的输入框中显示的 按钮。如下所示：

注意：是恢复到本次对话之前的状态，不是本次对话产生的状态。

2.2.3.3 历史和新建会话

可以通过 Chat 中的 图标按钮或者使用快捷键 .

开启新任务、避免对话混乱、保留特定记录或解决误操作时，需要在 Cursor 的 Chat 新建会话。

2.2.4 Chat 相关配置说明

Chat 相关配置修改位置：.

• Default new chat mode：设置新 Chat 会话的默认模式。
• Text Size：调整 Chat 窗口消息文字大小，Default 是默认尺寸，可按需改显示效果。
• Auto-Clear Chat：勾选后，聊天面板闲置再打开时自动新建聊天，保持交互新鲜度，避免旧聊天堆积干扰。
• Scroll to New Message：新消息生成时自动滚动到聊天面板底部，无需手动翻阅，方便实时查看最新内容。
• Completion Sound：开启后，当 Agent 完成响应时播放音效。
• To-Do List：是否允许 Agent 使用待办事项列表来跟踪任务的进度。
• Queue Message：当启用时，且模型正在流式传输时，后续消息将排队并按照接收顺序发送。
• Custom modes（BETA）：允许创建自定义模式，可按需定制交互逻辑，尚在测试，探索个性化玩法。
• Include Full-Folder Context：是否允许当前项目文件夹的全部内容被包含在上下文中。
• Web Search Tool：是否允许 Agent 联网搜索信息。
• Hierarchical Cursor Ignore：启用后， 文件规则作用于所有子目录，修改后需要重启 Cursor.
• Out-of-Context Edits in Manual mode：手动模式下，允许聊天对当前上下文外的文件自动应用更改，拓展操作范围，处理跨文件任务更便捷。
• Auto-Fix Lints：是否允许在 Chat 中自动修复错误。
• Auto-Accepts on Commit：当文件被修改或提交（commit）时，系统会自动接受这些更改。

2.3 内联智能修改

内联智能修改（快捷键：）功能是直接在编辑器窗口中生成新代码或编辑现有代码，适合精准修改代码内容。

在 Cursor 中，将按 时出现的弹窗称为 Prompt Bar。它的工作原理类似于在指定代码文件中的 Chat 功能，可以在代码文件中指定区域输入，或使用 @ 引用其他上下文。

内联智能修改的三大功能：

• 内联生成：如果在按 时未选择任何代码，Cursor 将根据在提示栏中输入的提示生成新代码。
• 内联编辑：如需重构代码，选中要编辑的代码块，按 后在提示栏中输入需求信息，完成代码重构。
• 终端命令执行：在终端中，按 后在提示栏中输入需求信息，生成脚本命令，然后运行操作。

2.3.1 代码文件中使用

• 内联生成

1、创建一个 文件，光标放文件末尾（无选中代码）

2、按 ，输入提示

3、实现效果

• 内联编辑

1、继续打开刚刚

2、选中代码块，按 ，输入提示：

3、实现效果

2.3.2 终端中使用

在 Cursor 中，内联智能修改功能除了能在代码文件中使用，还支持在终端（Terminal）中使用。

在 Cursor 中，可使用快捷键 + 反引号键在编辑器底部打开终端窗口。

把光标定位在终端中，按 打开终端底部的提示栏。输入需求，然后生成脚本命令，使用 接受并运行命令，也可以通过按 拒绝命令。

在 Cursor 工具里，上下文（Context） 可理解为让 AI 准确理解需求、辅助编码的信息参考范围，是 AI 读懂代码、精准响应的关键。

3.1 Codebase Indexing 代码库索引

3.1.1 概念和作用

打开项目文件夹时，每个 Cursor 实例都将初始化该工作区的索引。

初始索引设置完成后，Cursor 将自动为添加到工作区的任何新文件编制索引，以保证当前是最新的代码库上下文。

作用：

• 快速 “读懂” 你的项目结构（哪些是工具文件、哪些是业务逻辑）
• 定位相关代码（如搜索 时，知道优先查 ）
• 理解代码关系（如 类和 类的关联）

AI 分析索引内容后，生成代码时会更贴合项目实际（如使用已有工具函数、遵循命名规范）。

3.1.2 代码库索引配置和示例

代码库索引的配置位于：

测试示例：

展示效果：

3.1.3 忽略文件配置

Cursor 会读取项目的代码库并为其编制索引以支持其功能。可以通过将 文件添加到项目根目录来控制哪些文件被忽略和限制 Cursor 访问。

作用：

• 提升索引速度：排除一些没有用的模块依赖、生成文件（如 、）
• 避免干扰：某些配置文件可能包含敏感信息或与当前任务无关

配置 忽略文件的两种方式：

• 在项目根目录下创建 文件，并列出要忽略的目录和文件
• 使用 Cursor 配置快捷创建忽略文件

忽略文件配置测试：

1、创建忽略文件

2、添加忽略文件配置

3、测试

4、效果展示，可以看到对应的文件已经被忽略了

3.2 Rules 规则

3.2.1 Rules 规则介绍

Rules 是给 Cursor AI 功能（规则适用于 Chat 和内联智能修改）生成的代码结果添加规则和限制，让 AI 生成的代码贴合团队规范，减少人工二次修改成本。

作用：

• 约束代码风格，如强制用驼峰命名、要求函数必须写注释
• 限定技术选型，如禁止使用某老旧库、优先用项目指定工具类
• 指定核心参数，如提前设置连接数据库的地址和账号密码等

Rule 主要的配置方案有两种：

注意：项目规则和用户规则同时存在并且规则冲突，项目规则优先级更高。

3.2.2 项目规则配置

1、项目下创建规则文件

可通过如下两种方式进行创建：

• 手动创建规则文件：
• 使用快捷命令方式创建：使用 唤起命令面板，然后输入New Cursor Rule，输入规则文件名，进行创建

2、编写项目规则文件

规则文件的语法后文会介绍。

3、创建一个 文件，使用内联智能修改功能生成代码

4、项目规则生效效果展示

3.2.3 用户规则配置

1、用户规则在 Cursor Settings > Rules & Memories 中定义

2、添加规则内容

3、用户规则不支持 MDC, 只是纯文本

3.2.4 MDC 语法

Cursor 的 MDC（Markdown with Cursor）语法是专门为编写项目规则设计的轻量级格式，结合了 Markdown 的可读性和元数据配置能力。

3.2.4.1 MDC 文件组成部分

1、前置元数据（Frontmatter）

• 用 包裹的 YAML 格式配置
• 定义规则的基本属性（如作用范围、优先级）

2、规则内容（Markdown 正文）：用 Markdown 语法写具体规则

3.2.4.2 前置元数据

常用元数据字段

3.2.4.3 规则内容（Markdown 正文）

用 Markdown 的标题、列表、代码块等语法写具体规则，常见结构：

• 代码风格规则（最常用）

• 安全约束规则

• 特殊语法：引用项目文件

用 引用项目内的配置文件，让 AI 参考：

3.2.4.4 完整示例（TypeScript 项目规则）

3.3 @ 符号

在 Cursor 的 Chat 和内联智能修改功能中可以使用 @ 符号中引用代码、文件、文档和其他上下文的指南，直接更具体的指定上下文环境。

以下是所有可用 @ 符号的列表：

• @Files - 引用项目中的特定文件
• @Folders - 引用整个文件夹以获得更广泛的上下文
• @Code - 引用代码库中的特定代码片段或符号
• @Docs - 访问文档和指南
• @Git - 访问 git 历史记录和更改
• @Past Chats - 使用汇总的 Composer 会话
• @Rules - 使用规则
• @Terminals - 使用终端
• @Lint Errors - 引用 lint 错误（仅限 Chat）
• @Web- 参考外部 Web 资源和文档

3.3.1 @Files 使用和测试

1、准备测试文件

2、测试 @Test.js 对话

3、查看对话结果

3.3.2 @Code 使用和测试

1、还是使用前文的 文件

2、测试 @Code 对话

3、查看对话结果

3.3.3 @Docs 使用和测试

1、@Docs 作用说明

将 Cursor 连接到来自常用工具和框架的官方文档，当需要以下内容的最新权威信息时，请使用它：

• API 参考：函数签名、参数、返回类型
• 入门指南：设置、配置、基本用法
• **做法：源中的推荐模式
• 特定于框架的调试：官方故障排除指南

2、@Docs 文档配置

可以通过 来进行文档索引配置。

点击 Add Doc 输入文档地址，如添加 MyBatis-Plus 官网地址：

• name：一般用于标识文档的名称、简称或唯一识别名，方便在 Cursor 中区分不同文档配置。比如这里填 ，就是用框架名称作为文档标识，后续可通过这个 快速找到、关联对应的文档配置。
• prefix：通常指文档 URL 的前缀部分，可用于拼接完整文档路径，或作为统一的基础地址标识。如 , 该框架文档介绍板块的基础前缀，后续若要拼接具体文档子页面路径（如某个功能详细说明路径 ），可以基于这个 去扩展，让文档地址管理更规整。
• entrypoint：一般是文档的入口地址，即用户访问该文档时最先进入的页面。这里的 就是文档的起始访问页面，用户通过这个 能直接进入到对应文档内容开始浏览。

3、测试 @Docs 对话

4、查看对话结果

3.3.4 @Web 使用和测试

1、@Web 作用说明

提供联网搜索当前信息、博客文章和社区讨论等资料的功能。

在特殊的场景下使用，如：

• 最新的教程：社区生成的内容和示例
• 比较：比较不同方法的文章
• 最近更新：Very Recent updates or announcement（最近的更新或公告）
• 多种视角：不同的问题处理方法

2、测试 @Web 对话

3、查看对话结果

4、对比 @Docs 和 MCP 配置的区别

3.3.5 @Linter Errors 使用和测试

1、@Linter Errors 作用和说明

符号会自动捕获并提供有关当前活动文件中的任何 linting 错误和警告的上下文。

2、准备代码

3、运行后，出现如下错误

4、使用 @Lint Errors 对话结局 Bug

4、测试结果