登录/ 注册
 找回密码
 立即注册
关闭

CSDN热搜

程序园 精品问答 技术交流 资源下载
返回列表 发新帖
首页 › 业界区 › 安全 ›Cursor 入门教程！

Cursor 入门教程！

乙荒 2025-9-26 11:30:26
1.png

文章已经收录到 GitHub 个人博客项目，欢迎 Star：
  1. https://github.com/chenyl8848/chenyl8848.github.io
复制代码
或者访问网站，进行在线浏览：
  1. https://chencoding.top/
复制代码
1. Cursor 概述、安装以及环境配置

1.1 概述

Cursor 是一款功能强大的 AI 优先代码编辑器，可增强开发工作流程。
主要提供三个核心方向：

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

关注微信公众号：【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 官网并单击下载按钮
  1. https://cursor.com/
复制代码
2、运行安装程序并等待安装完成
3、通过桌面快捷方式或从应用菜单启动 Cursor
1.2.2 登录

1、点击注册或登录后，系统会提示您设置一个帐户。可以选择使用邮件，或者使用 Google 或 GitHub 账号登录。
如果第一次使用 Cursor，将获得 14 天的免费试用期。
2、登录后，送回 Cursor，然后就可以开始编码了。
1.2.3 无限续杯

新注册的 Cursor 用户有着 14 天免费，50 次免费高级提问的额度，但是也很轻易就会达到上限。
Cursor 会通过检测用户的邮箱账号以及电脑的机器码进行识别，我们出于学习的意图，可以尝试在达到上限后绕过这些限制继续学习。
推荐进行付费使用，功能也会更强大！


  • 准备新邮箱
​可以去 2925 邮箱注册一个账号，这个邮箱平台的一个优势是用户申请的邮箱之后，可以自行创建子邮箱。
比如，创建了 CodeChen@2925.com 这个邮箱，那么我们在 Cursor 申请账号的时候，可以使用 CodeChen123@2925.com、CodeChenabc@2925.com、CodeChen666@2925.com 等邮箱进行注册（也就是 CodeChen数字随意@2925.com），当使用这些子邮箱注册时，会在主邮箱中收到邮件，这样就可以无限制创建和使用邮箱。
3.png

2925 邮箱注册地址：
  1. https://www.2925.com/
复制代码

  • 机器码识别破解
Cursor 的团队意识到了开发者会通过换邮箱的方式投机取巧，于是加入了校验本机机器码的环节。即使用户注册了一个新的邮箱，但是机器码所属的额度用完之后，也是不能继续免费了。
俗话说，你有张良计，我有过墙梯。有个开源项目 cursor-free-vip 针对 Cursor 的机器码识别问题，提供了重置机器码和快速注册新账号等功能。
1、下载 cusor-free-vip
  1. https://github.com/yeongpin/cursor-free-vip/releases
复制代码
2、鼠标右键以管理员身份运行 cusor-free-vip
4.png

3、输入 1，重置机器 ID
4、输入 2，自动在浏览器中打开 Cursor 注册页面，使用新邮箱重新注册
5、注册成功后，在 Cursor 中登录新账号
1.3 Cursor 设置

在 Cursor 中，具有 Cursor Settings 和 Editor Settings 两个不同的配置入口，分别用于管理 AI 功能 和 编辑器基础设置。
二者的区别如下：
对比项Cursor SettingsEditor Settings功能定位管理 AI 相关功能和 Cursor 特有设置调整编辑器基础行为和外观继承性Cursor 独有功能大部分继承自 VS Code（如主题设置）影响范围影响 AI 代码生成、分析、对话的效果影响代码编辑体验（如排版、颜色）典型配置示例调整 AI 模型参数、代码库索引路径修改字体、启用自动保存、更改主题快捷键Ctrl + Shift + JCtrl + Shift + P1.3.1 Cursor AI 配置

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

以下是对 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 编辑器配置

使用快捷键 Ctrl + Shift + P 打开控制面板，输入 Preferences: Open Settings (UI).
编辑器设置和 VS Code 的设置界面一致。
6.png

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

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

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

Cursor 汉化步骤如下：

  • 打开扩展：启动 Cursor 后，使用快捷键 Ctrl + Shift + X，左侧边栏会出现扩展商店界面。
  • 搜索并安装插件：在搜索框输入Chinese或中文，一般选择下载量最高的Chinese (Simplified) Language Pack for Visual Studio Code，点击安装按钮进行安装。
  • 打开命令面板：按下 Ctrl + Shift + P，输入 Configure Display Language 并回车，进入语言配置界面。
  • 选择中文并重启：在弹出的语言列表中选择 "中文（简体）" 或 "zh-cn" ，保存设置后重启 Cursor.
  • 重启 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 系统：导入的是 %appdata%\code\user\ 路径下的 settings.json 配置文件
  • MacOS 系统：导入的是 ~/Library/Application Support/Code/User/ 路径下的配置内容
  • Linux 系统: 导入的是 ~/.config/code/user/ 路径下的配置文件
注意：并非所有 VS Code 扩展都与 Cursor 兼容。一些依赖 VS Code 特定 API 的插件，在导入时可能导致整个导入过程失败或部分功能（如主题显示）异常。
如在安装 Cursor 时未设置导入 VS Code 配置，可通过如下方式手动导入：

  • 打开 Cursor 设置中心（Ctrl + Shift + J）
  • 导航到 General（常规） --> Preferences（首选项）
  • 在 Importing Setiings from VS Code（从 VS Code 导入设置） 下，单击 Import（导入） 按钮
7.png

1.4.2 手动迁移

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

  • 导出配置文件

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


  • 导入配置文件

  • 在 Cursor 实例上，打开设置中心（Ctrl + Shift + P）
  • 搜索 Preferences： Open Profiles （UI）
  • 单击 New Profile 旁边的下拉菜单，然后单击 Import Profile
  • 粘贴 GitHub Gist 的 URL 或选择选择文件以上传本地文件
  • 单击对话框底部的 Import 以保存配置文件
  • 最后，在侧边栏中，选择新的配置文件，然后单击勾号图标将其激活
1.5 配置 Java 语言环境

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


  • 自动读取情况
如果在系统环境变量中正确配置了 JAVA_HOME 和 MAVEN_HOME ，且环境变量配置无误（变量值准确指向 JDK 和 Maven 的安装目录 ），部分情况下 Cursor 能自动识别并应用这些配置。
比如，当你在 Cursor 中创建、运行或调试 Java 项目时，它可能会利用自动读取到的环境变量来找到对应的 JDK 和 Maven 位置，完成代码编译、项目构建等操作。

  • 手动配置情况
如果 Cursor 没有自动读取到 JDK 和 Maven 配置，就需要手动配置，步骤如下：
1、在 Cursor 输入快捷键 Ctrl + Shift + P 打开命令面板
2、输入 Preferences: Open User Settings (JSON) 并回车，打开 settings.json 文件
3、然后添加或修改以下内容：
  1. {
  2.     ....
  3.     // 配置 JDK
  4.     "java.home": "D:/program/jdk1.8",
  5.     // 或者使用如下属性配置 JDK
  6.     "java.jdt.ls.java.home": "D:/program/jdk1.8",
  7.     // 配置 JDK 的多版本，类似于在 IDEA 中的 Project Settings 中选择不同的 Java 运行环境，用于项目启动
  8.     "java.configuration.runtimes": [
  9.         {
  10.             "name": "JavaSE-1.8",
  11.             "path": "D:/program/jdk1.8",
  12.             "default": true
  13.         },
  14.         {
  15.             "name": "JavaSE-11",
  16.             "path": "D:/program/jdk11",
  17.         },
  18.         {
  19.             "name": "JavaSE-17",
  20.             "path": "D:/program/jdk17"
  21.         },
  22.     ],
  23.     // Maven 环境配置
  24.     "java.configuration.maven.userSettings": "D:/program/apache-maven-3.6.3/conf/settings.xml"
  25. }
复制代码
保存文件后，重启 Cursor 使配置生效。
1.5.2 安装 Java 环境相关插件

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

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

  • Language Support for Java(TM) by Red Hat
提供语法高亮、智能代码补全、代码检查、代码格式化（Shift + Option/Alt + F）、代码导航以及重构支持等功能，辅助高效编写和优化 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 编辑器。

  • 环境要求：已安装 Cursor、IDEA 2022.3 及以上版本
  • 安装：在 IDEA 的插件市场搜索 switch2cursor 进行安装
  • 配置 Cursor 路径：在 IDEA 中打开 Settings → Tools → Switch2Cursor 配置 Cursor Path 为你的 Cursor 可执行文件的路径，如：D:\software\cursor\Cursor.exe 需要替换成自己电脑的 Cursor 安装路径
  • 使用快捷键切换到 Cursor：

    • 打开项目：Option/Alt + Shift + P
    • 打开当前文件：Option/Alt + Shift + O



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

  • 安装：在 Cursor 扩展市场中搜索 "Switch2IDEA" 并安装
  • 配置 IDEA 路径：打开 Cursor 设置，点击 General → Editor → open editor settings → Extensions → Switch2IDEA → Idea Path
  • 配置 IDEA 安装路径
  • 使用快捷键切换到 IDEA：

    • 打开项目：Option/Alt + Shift + P
    • 打开当前文件：Option/Alt + Shift + O

2. Cursor 三大核心 AI 功能

2.1 Tab 键：代码自动补全

Cursor 的 Tab 键具有强大的代码自动补全功能，基于 AI 模型，能根据代码上下文自动预测并生成代码补全建议和代码修复重构，还可用于代码自动联想等。
使用方式：使用 Tab 键接受建议，Esc 键拒绝建议，Ctrl + → 逐字部分接受建议（部分接受功能需要启用 Partial Accepts 配置项）。
2.1.1 单行/多行代码补全


  • 新建一个工具类，在类中写上注释计算数组平均值
  1. public class ArrayUtil {
  3.     // 计算数组平均值
  4. }
复制代码

  • 按 Tab 键，Cursor 自动生成代码
  1. public class ArrayUtil {
  3.     // 计算数组平均值
  4.     public static double average(int[] array) {
  5.         if (array == null || array.length == 0) {
  6.             return 0;
  7.         }
  8.         int sum = 0;
  9.         for (int i = 0; i < array.length; i++) {
  10.             sum += array[i];
  11.         }
  12.         return (double) sum / array.length;
  13.     }
  14. }
复制代码
2.1.2 智能代码重写


  • 已有代码如下：
  1. import java.util.ArrayList;
  2. import java.util.Arrays;
  3. import java.util.List;
  5. /**
  6. * 数组工具类
  7. *
  8. * @author
  9. * @version 1.0
  10. * @since 1.0
  11. */
  12. public class ArrayUtil {
  14.     // 计算数组平均值
  15.     public static double average(int[] array) {
  16.         if (array == null || array.length == 0) {
  17.             return 0;
  18.         }
  19.         int sum = 0;
  20.         for (int i = 0; i < array.length; i++) {
  21.             sum += array[i];
  22.         }
  23.         return (double) sum / array.length;
  24.     }
  26.     public void arrayFor() {   
  27.         List<Integer> numbers = Arrays.asList(1, 2, 3, 4, 5);
  28.         List<Integer> evenNumbers = new ArrayList<>();
  29.         for (int num : numbers) {
  30.             if (num % 2 == 0) {
  31.                 evenNumbers.add(num);
  32.             }
  33.         }
  34.     }
  35. }
复制代码

  • 使用 Stream 重构 arrayFor 方法，按 Tab 键，自动补全：
  1. // 使用 stream
  2. // 光标放在方法块的任意位置，按 Tab 键
  3. public void arrayFor() {   
  4.     List<Integer> numbers = Arrays.asList(1, 2, 3, 4, 5);
  5.     List<Integer> evenNumbers = numbers.stream().filter(num -> num % 2 == 0).collect(Collectors.toList());
  6. }
复制代码
2.1.3 自动联想

新建一个 POJO 类，输入几个变量后，Cursor 会自动联想，使用 Tab 键快速生成代码。
  1. public class Person {
  2.     // 姓名
  3.     private String name;
  4.     // 年龄
  5.     private int age;
  6.     // 性别
  7.     private String gender;
  8.     // Cursor 会继续联想变量类型，按 Tab 键快速生成
  9. }
复制代码
2.1.4 Tab 相关配置

Tab 相关配置修改位置：Cursor Settings > Tab.
9.png


  • Cursor Tab：启用/禁用 Tab 功能。相当于“总开关”，启用后才能用 Tab 键触发 AI 代码建议（如多行补全、智能续写）；取消勾选则 Tab 仅作普通缩进。
  • Partial Accepts：部分建议功能，启用后，可使用 Ctrl + → 逐个单词接受 AI 建议。比如 AI 建议 const fullName = firstName + " " + lastName;，但你只想用 firstName +  部分，就可通过该快捷键拆分接受。
  • Suggestions While Commenting：控制是否在注释里也提供 Tab 建议。写注释时，Tab 键同样会帮你补全思路。如输入 // 实现冒泡排序的步骤：，按 Tab 自动续写步骤说明。
  • Whitespace Only Suggestions：控制是否显示仅包含空白（空格、换行、格式化代码）的 AI 建议。这个配置项决定了当按 Tab 时，是否让那些只调整空格、换行、缩进（没有实际代码逻辑变化）的建议显示出来。
比如，如下代码格式不齐整：
  1. public class Demo {
  2. public void test() {
  3. System.out.println("Hello");
  4.     if (true) {
  5. System.out.println("World");
  6.     }
  7. }
  8. }
复制代码

  • 勾选：把光标放在混乱的代码里（比如 public void test() { 这行后面） Tab 会有修改建议
  • 不勾选：把光标放在混乱的代码里（比如 public void test() { 这行后面） Tab 不会有修改建议
10.png


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

Chat（之前称Composer）是 Cursor 的 AI 助手，位于编辑器的侧边栏中，通过自然语言与代码库进行交互。
可以提出问题、请求代码编辑、获取终端命令建议等。
11.png

Cursor Chat 主要功能：

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

使用 Ctrl + L 打开侧边栏中的聊天窗口，用中文文字输入请求，Cursor 将做出相应的响应。
注意：与 Chat 对话时，建议采用清晰、具体的语言格式，最好包含任务类型、上下文描述和具体要求。
以下是几个参考模板：

  • 代码生成类
  1. [任务类型]：请生成一个 {功能描述} 的 {编程语言/框架} 实现
  3. [具体要求]：
  4. 1. 使用 {特定技术/库}
  5. 2. 包含 {特定功能点}
  6. 3. 符合 {编码规范/设计模式}
复制代码
示例：
  1. 请生成一个学习计划页面的 HTML + CSS + JavaScript 实现
  3. [具体要求]：
  4. 1. 使用Tailwind CSS v3 和 Font Awesome
  5. 2. 包含任务添加、编辑、删除功能
  6. 3. 包含日历视图展示学习计划
  7. 4. 包含学习进度可视化图表
  8. 5. 符合现代UI设计原则和响应式设计
  9. 6. 具有平滑的动画和交互效果
复制代码

  • 代码修改类
  1. [任务类型]：请帮我修改 {上下文：具体文件/代码片段}，实现 {预期功能}
  3. [当前问题]：{现有的错误/不足描述}
  5. [具体要求]：
  6. 1. 保持 {现有功能/结构} 不变
  7. 2. 使用 {特定方法/技术} 改进
  8. 3. 修复 {具体错误/警告}
复制代码
示例：
  1. 请帮我修改当前的 React 组件，优化列表渲染性能。
  2. 当前问题：滚动时列表卡顿，存在明显性能问题。
  3. 要求：
  4. 1. 保持现有 UI 不变
  5. 2. 使用 React.memo 和虚拟列表技术优化
  6. 3. 添加性能监控日志
复制代码

  • 代码解释类
  1. [任务类型]：请解释 {代码片段/功能模块} 的 {具体方面}
  3. [上下文信息]：{相关业务背景/技术栈}
  5. [具体问题]：
  6. 1. {不理解的语法/逻辑}
  7. 2. {特定设计选择的原因}
  8. 3. {潜在的问题/优化点}
复制代码
示例：
  1. 请解释这段 TypeScript 代码的泛型约束和类型推导逻辑。
  2. 上下文：这是一个用于数据验证的工具函数。
  3. 具体问题：
  4. 1. <T extends object> 这里为什么要加 extends object？
  5. 2. 类型推导是如何工作的？
  6. 3. 是否存在类型安全隐患？
复制代码

  • 流程自动化类
  1. [任务类型]：请创建一个自动化流程，实现 {目标描述}
  3. [操作步骤]：
  4. 1. 从 {数据源} 获取 {数据类型}
  5. 2. 执行 {数据处理/转换操作}
  6. 3. 将结果保存到 {目标位置}
  7. 4. 触发 {后续操作/通知}
  9. [具体要求]：
  10. 1. 使用 {特定工具/API}
  11. 2. 添加 {错误处理/重试机制}
  12. 3. 生成 {日志/报告}
复制代码
示例：
  1. 请创建一个自动化流程，每天凌晨从 GitHub API 获取仓库星标数，保存到 Google Sheets 并生成趋势图。
  2. 要求：
  3. 1. 使用 GitHub REST API v3
  4. 2. 添加异常处理和邮件通知
  5. 3. 生成周/月增长趋势图表
复制代码

  • 命令行辅助类
  1. [任务类型]：请提供 {操作场景} 的 {操作系统} 命令
  3. [具体需求]：
  4. 1. {执行的具体操作}
  5. 2. 包含 {特定参数/选项}
  6. 3. 处理 {特殊情况/错误}
复制代码
示例：
  1. 请提供在 macOS 上批量压缩图片的命令行方案。
  2. 需求：
  3. 1. 将当前目录下所有 PNG/JPG 图片压缩 50%
  4. 2. 保留原始文件并添加 "-compressed" 后缀
  5. 3. 显示每个文件的压缩前后大小对比
复制代码
提示词技巧总结：

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

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

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

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

  • 独立探索项目代码，识别相关文件，并进行必要的更改
  • 使用所有可用工具搜索、编辑、创建文件和运行终端命令
  • 全面了解项目结构和依赖关系
  • 将复杂任务分解为可管理的步骤并按顺序执行
生成和修改示例：
1、新建一个文件夹，并在 Cursor 中打开
2、使用 Ctrl + L 打开对话模式（默认 Agent 模式）
3、输入用例对话
  1. 使用 HTML、Css、Javascript 来实现一个贪吃蛇页面。
  2. 要求：
  3. 1. 要求有积分统计
  4. 2. 页面要有多种背景可以切换
  5. 3. 代码添加中文注释
  6. 4. 不能使用 var 只能使用 let 和 const 声明变量
复制代码
4、发送需求，并等待生成代码
5、运行代码对话
  1. 将 Html 页面在 Chrome 浏览器打开
复制代码
6、后续进行对话，进行代码调整或者添加新需求
  1. 添加开始游戏按钮，点击后才开始游戏
复制代码
Agent 的配置选项：
12.png

13.png


  • Model（模型选择）：选择使用哪种大模型
  • Keybindings（快捷键设置）： 为 Agent 模式设置快速开启快捷键（默认 Ctrl + I）
  • Auto-run（自动运行）：当你让 Agent 修改代码后，自动执行相关命令（如编译、测试、运行），验证修改的正确性
  • Auto-fix errors（自动修复）：当自动运行过程中出现错误（如编译失败、测试报错），Agent 会尝试分析错误信息并自动修复
错误调试和修改示例：
1、准备错误信息类
  1. public class ArrayDemo {
  2.     public static void main(String[] args) {
  3.         // 创建一个整数数组
  4.         int[] numbers = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};
  5.         
  6.         // 使用 for 循环输出数组内容
  7.         System.out.println("数组内容如下：");
  8.         for (int i = 0; i < numbers.length; i++) {
  9.             // 此处 i + 2 就会出现下角标越界错误
  10.             System.out.println("第 " + (i + 1) + " 个元素是: " + numbers[i + 2]);
  11.         }
  12.     }
  13. }
复制代码
2、运行时出现如下报错信息
14.png

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

2.2.2.2 Ask 模式

Ask 是 Chat 的只读模式，用于提出问题、探索和了解代码库。
Ask 是其他模式（Agent 和 Manual）所独有的，因为它默认不自动应用任何建议的更改，这使它成为一种只读模式，具有读取文件和其他上下文的完整能力，但不能自行进行任何更改。
适合在不想更改代码库或在实施之前使用 AI 规划解决方案的场景下使用。
如在 Ask 模式下给贪吃蛇添加多种游戏模式：
16.png

Ask 的配置选项：
17.png


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

与 Ask 模式不同，Manual 模式不探索代码库或运行终端命令。
完全取决于具体说明和提供的上下文（例如，通过 @文件名），AI 生成修改建议后，还需要用户手动点击应用才会改动代码，而且通常是单文件/局部代码调整。
如给代码添加注释：
18.png

Manual 的配置选项：
19.png

2.2.3 Chat 模式的其他细节

2.2.3.1 代码编辑选项

当 Chat 建议更改代码时：
1、Review changes：在差异视图中查看建议的更改
20.png

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

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

3.2.3.2 Checkpoints 数据还原

有些情况，需要恢复到代码库的先前状态。Cursor 通过在发出的每个请求以及每次 AI 更改的代码库时自动创建代码库的检查点（Checkpoints）来帮助解决这个问题，类似于 Git 版本管理中的回滚操作。
要恢复到之前的状态，可以：单击上一个请求的输入框中显示的 Restore Checkpoint 按钮。如下所示：
23.png

注意：是恢复到本次对话之前的状态，不是本次对话产生的状态。
2.2.3.3 历史和新建会话

可以通过 Chat 中的 Show history 图标按钮或者使用快捷键 Ctrl + Alt + '.
24.png

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

2.2.4 Chat 相关配置说明

Chat 相关配置修改位置：Cursor Settings > Chat.
26.png


  • 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：启用后，.cursorignore 文件规则作用于所有子目录，修改后需要重启 Cursor.
  • Out-of-Context Edits in Manual mode：手动模式下，允许聊天对当前上下文外的文件自动应用更改，拓展操作范围，处理跨文件任务更便捷。
  • Auto-Fix Lints：是否允许在 Chat 中自动修复错误。
  • Auto-Accepts on Commit：当文件被修改或提交（commit）时，系统会自动接受这些更改。
2.3 内联智能修改

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

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

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


  • 内联生成
1、创建一个 main.js 文件，光标放文件末尾（无选中代码）
2、按 Ctrl + K，输入提示
  1. 生成一个带点击动画的按钮组件，用 JavaScript 实现，点击后控制台打印次数
复制代码
3、实现效果
28.png


  • 内联编辑
1、继续打开刚刚 main.js
2、选中代码块，按 Ctrl + K，输入提示：
  1. 添加注释和每行代码添加注释说明
复制代码
3、实现效果
29.png

2.3.2 终端中使用

在 Cursor 中，内联智能修改功能除了能在代码文件中使用，还支持在终端（Terminal）中使用。
在 Cursor 中，可使用快捷键 Ctrl + 反引号键在编辑器底部打开终端窗口。
把光标定位在终端中，按 Ctrl + K 打开终端底部的提示栏。输入需求，然后生成脚本命令，使用 Ctrl + Enter 接受并运行命令，也可以通过按 Esc 拒绝命令。
30.png

3. Cursor 精准上下文指定

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

3.1.1 概念和作用

打开项目文件夹时，每个 Cursor 实例都将初始化该工作区的索引。
初始索引设置完成后，Cursor 将自动为添加到工作区的任何新文件编制索引，以保证当前是最新的代码库上下文。
作用：

  • 快速 “读懂” 你的项目结构（哪些是工具文件、哪些是业务逻辑）
  • 定位相关代码（如搜索 getUser 时，知道优先查 userService.js）
  • 理解代码关系（如 Order 类和 Product 类的关联）
AI 分析索引内容后，生成代码时会更贴合项目实际（如使用已有工具函数、遵循命名规范）。
3.1.2 代码库索引配置和示例

代码库索引的配置位于：Cursor Settings > Indexing & Docs
31.png

测试示例：
  1. 查看当前项目结构，并使用文字图形形式罗列出来
复制代码
展示效果：
32.png

3.1.3 忽略文件配置

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

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

  • 在项目根目录下创建 .cursorignore 文件，并列出要忽略的目录和文件
  • 使用 Cursor 配置快捷创建忽略文件 Cursor Settings > Indexing & Docs > Ignored Files in .cursorignore
忽略文件配置测试：
1、创建忽略文件
33.png

2、添加忽略文件配置
  1. # Add directories or file patterns to ignore during indexing (e.g. foo/ or *.csv)
  2. main.js
  3. ArrayDemo.class
复制代码
3、测试
  1. 查看当前项目结构，并使用文字图形形式罗列出来
复制代码
4、效果展示，可以看到对应的文件已经被忽略了
34.png

3.2 Rules 规则

3.2.1 Rules 规则介绍

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

  • 约束代码风格，如强制用驼峰命名、要求函数必须写注释
  • 限定技术选型，如禁止使用某老旧库、优先用项目指定工具类
  • 指定核心参数，如提前设置连接数据库的地址和账号密码等
Rule 主要的配置方案有两种：
维度项目规则（Project Rules）用户规则（User Rules）作用范围仅对当前项目生效，团队成员共享相同规则对所有项目生效，个人专属配置存储位置项目根目录下的 .cursor/rules/随意.mdc 文件用户配置目录（如 ~/.cursor/rules）同步方式随项目代码提交到版本库（如 Git），团队共享仅本地生效，不随项目同步适用场景统一团队编码规范（如函数注释格式、依赖版本）个人习惯（如快捷键、AI 响应风格）注意：项目规则和用户规则同时存在并且规则冲突，项目规则优先级更高。
3.2.2 项目规则配置

1、项目下创建规则文件
可通过如下两种方式进行创建：

  • 手动创建规则文件：项目/.cursor/rules/随意命名.mdc
  • 使用快捷命令方式创建：使用 Ctrl + Shift + P 唤起命令面板，然后输入New Cursor Rule，输入规则文件名，进行创建
35.png

2、编写项目规则文件
  1. ---
  2. description: "团队前端项目规范"
  3. priority: 1000
  4. ---
  6. # 代码风格
  7. 1. 函数必须包含 JSDoc 注释
  8. 2. 禁止使用 `var`, 统一用 `const`/`let`
  9. 3. 函数命名必须添加 code_ 前缀，例如：code_login
  11. # 依赖管理
  12. - 优先使用项目内已有的工具函数（如 `utils/request`）
  13. - 禁止引入低版本的 lodash（<4.0.0）
复制代码
常用元数据字段
字段作用示例description描述规则用途，指导 AI 如何应用规则"前端组件编码规范"globs指定规则生效的文件范围（支持 glob 语法）"src/**/*.{js,ts,jsx}"priority规则优先级（数值越大越优先），解决规则冲突1000version规则版本号（可选）"1.0.0"3.2.4.3 规则内容（Markdown 正文）

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

  • 代码风格规则（最常用）
  1. 生成两个方法一个登录一个注册
复制代码

  • 安全约束规则
  1. ---
  2. # 官方约定字段（推荐用，AI 更易理解）
  3. description: "前端项目规则"
  4. globs: "src/**/*.tsx"
  5. priority: 1000
  7. # 自定义字段（自己或团队约定含义）
  8. author: "技术团队"
  9. review_date: "2025-06-04"
  10. special_rule: "仅周一至周五生效"
  11. ---
复制代码

  • 特殊语法：引用项目文件
用 @file 引用项目内的配置文件，让 AI 参考：
  1. # 一、代码风格
  2. 1. 函数必须包含 JSDoc 注释  
  3.    - 至少包含 `@param` 和 `@return` 描述  
  4. 2. 变量命名必须使用驼峰命名法（camelCase）  
  5. 3. 每行代码长度不超过 120 个字符  
  7. # 二、技术选型
  8. - 禁止直接使用原生 fetch，必须通过项目封装的 request 工具  
  9. - 优先使用 React Hooks 而非 Class 组件  
复制代码
3.2.4.4 完整示例（TypeScript 项目规则）
  1. # 安全规范
  2. 1. 禁止使用 eval() 函数  
  3. 2. SQL 查询必须使用参数化查询，防止注入攻击  
  4. 3. 敏感信息（如 API 密钥）必须从环境变量读取  
复制代码
3.3 @ 符号

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

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

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

1、准备测试文件 test.js
  1. # 工具链配置
  2. 1. ESLint 规则必须符合 @file .eslintrc.js  
  3. 2. 测试用例必须遵循 Jest 框架规范  
复制代码
2、测试 @Test.js 对话
  1. ---
  2. description: "TypeScript 项目编码规范"
  3. globs: "src/**/*.ts"
  4. priority: 1000
  5. ---
  7. # 一、基础规范
  8. 1. 所有文件必须使用 UTF-8 编码  
  9. 2. 统一使用 2 空格缩进  
  11. # 二、类型约束
  12. 1. 禁止使用隐式 any 类型  
  13.    - 示例：`const num: number = 123`（显式）  
  14.    - 禁止：`const num = 123`（隐式）  
  15. 2. 接口命名必须以 `I` 开头（如 `interface IUser`）  
  17. # 三、项目约束
  18. - 所有 HTTP 请求必须通过 @file src/utils/request.ts 封装的工具  
  19. - 状态管理必须使用 Redux Toolkit，禁止直接修改 state  
复制代码
3、查看对话结果
38.png

3.3.2 @Code 使用和测试

1、还是使用前文的 test.js 文件
2、测试 @Code 对话
  1. /**
  2. * 用户登录方法
  3. * @param {string} username 用户名
  4. * @param {string} password 密码
  5. * @returns {Promise<Object>} 登录结果
  6. */
  7. function code_login(username, password) {
  8.     return new Promise((resolve, reject) => {
  9.         if (!username || !password) {
  10.             reject({ success: false, message: '用户名和密码不能为空' });
  11.             return;
  12.         }
  13.         // 模拟登录逻辑
  14.         setTimeout(() => {
  15.             if (username === 'admin' && password === '123456') {
  16.                 resolve({ success: true, message: '登录成功', token: 'mock_token_123' });
  17.             } else {
  18.                 reject({ success: false, message: '用户名或密码错误' });
  19.             }
  20.         }, 500);
  21.     });
  22. }
  24. /**
  25. * 用户注册方法
  26. * @param {string} username 用户名
  27. * @param {string} password 密码
  28. * @returns {Promise<Object>} 注册结果
  29. */
  30. function code_register(username, password) {
  31.     return new Promise((resolve, reject) => {
  32.         if (!username || !password) {
  33.             reject({ success: false, message: '用户名和密码不能为空' });
  34.             return;
  35.         }
  36.         // 模拟注册逻辑
  37.         setTimeout(() => {
  38.             if (username.length < 3) {
  39.                 reject({ success: false, message: '用户名长度不能少于3位' });
  40.             } else if (password.length < 6) {
  41.                 reject({ success: false, message: '密码长度不能少于6位' });
  42.             } else {
  43.                 resolve({ success: true, message: '注册成功', user: { username } });
  44.             }
  45.         }, 500);
  46.     });
  47. }
复制代码
3、查看对话结果
39.png

3.3.3 @Docs 使用和测试

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

  • API 参考：函数签名、参数、返回类型
  • 入门指南：设置、配置、基本用法
  • 最佳做法：源中的推荐模式
  • 特定于框架的调试：官方故障排除指南
2、@Docs 文档配置
可以通过 Cursor Settings > Indexing & Docs 来进行文档索引配置。
40.png

点击 Add Doc 输入文档地址，如添加 MyBatis-Plus 官网地址：
  1. 总结下 @test.js 里面的方法
复制代码
41.png


  • name：一般用于标识文档的名称、简称或唯一识别名，方便在 Cursor 中区分不同文档配置。比如这里填 MyBatis-Plus，就是用框架名称作为文档标识，后续可通过这个 name 快速找到、关联对应的文档配置。
  • prefix：通常指文档 URL 的前缀部分，可用于拼接完整文档路径，或作为统一的基础地址标识。如 https://baomidou.com, 该框架文档介绍板块的基础前缀，后续若要拼接具体文档子页面路径（如某个功能详细说明路径 ），可以基于这个 prefix 去扩展，让文档地址管理更规整。
  • entrypoint：一般是文档的入口地址，即用户访问该文档时最先进入的页面。这里的 总结下 @test.js 里面的方法 就是MyBatis-Plus文档的起始访问页面，用户通过这个 entrypoint 能直接进入到对应文档内容开始浏览。
3、测试 @Docs 对话
  1. 帮我逐行解释下 @zwf_register 代码的含义！并且最终在源文件中添加注释！
复制代码
4、查看对话结果
42.png

3.3.4 @Web 使用和测试

1、@Web 作用说明
@Web 提供联网搜索当前信息、博客文章和社区讨论等资料的功能。
在特殊的场景下使用，如：

  • 最新的教程：社区生成的内容和示例
  • 比较：比较不同方法的文章
  • 最近更新：Very Recent updates or announcement（最近的更新或公告）
  • 多种视角：不同的问题处理方法
2、测试 @Web 对话
  1. https://baomidou.com/introduce/
复制代码
3、查看对话结果
43.png

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

3.3.5 @Linter Errors 使用和测试

1、@Linter Errors 作用和说明
@Linter Errors 符号会自动捕获并提供有关当前活动文件中的任何 linting 错误和警告的上下文。
2、准备代码 BubbleSort.java
  1. @MyBatis-Plus 查询下乐观锁的使用
复制代码
3、运行后，出现如下错误
45.png

4、使用 @Lint Errors 对话结局 Bug
  1. @Web Java17 有哪些新特性
复制代码
4、测试结果
46.png


来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
Cursor入门教程
36.png

使用道具 举报

相关推荐
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册
发帖
乙荒
2025-9-26 11:30:26

0

粉丝关注

19

主题发布

板块介绍填写区域，请于后台编辑
微信扫一扫