一、引言：为什么Cursor是开发者的下一个必备工具

作为一名开发者，你是否经常陷入这样的困境：

  • 花大量时间写重复的样板代码？

  • 频繁在IDE和浏览器之间切换查文档？

  • 面对复杂的遗留代码，理不清头绪？

  • 调试时对着错误栈一筹莫展？

  • 学习新框架时，需要反复看教程、示例？

传统的IDE虽然强大，但它们只是被动的工具——你需要告诉它做什么，它才会执行。而AI编程助手的出现，彻底改变了这一现状。Cursor正是其中的佼佼者：它将大语言模型深度集成到IDE中，不仅能智能补全代码，还能理解整个项目，与你对话，协助你完成从设计到部署的全过程。

Cursor能为你做什么？

  • 智能补全：基于整个项目的上下文，预测你下一步要写的代码，甚至能补全多行。

  • 代码生成：用自然语言描述需求，直接生成函数、类、测试、配置文件。

  • 代码解释：选中一段代码，让AI解释它的逻辑、潜在问题。

  • 重构优化：让AI帮你重构代码，应用设计模式，提升性能。

  • 调试助手：粘贴错误信息，AI分析原因并给出修复方案。

  • 文档查询：不用离开编辑器，直接用@docs查询框架API。

  • 项目级问答：索引整个代码库后，可以问“用户认证流程是怎样的？”。

本文的目标是带你从入门到精通，不仅学会Cursor的基本操作，更掌握如何让它成为你团队中的“超级实习生”——理解你的项目规范，遵循你的编码风格，协助解决复杂问题。无论你是前端、后端、全栈还是数据科学家，这篇文章都将成为你使用Cursor的权威指南。

二、快速上手指南：安装与基础配置

1. 下载与安装

访问 cursor.sh 官网，下载对应操作系统的版本（Windows/macOS/Linux）。安装过程非常简单，一路下一步即可。

首次启动时，Cursor会询问你之前使用的编辑器（如VSCode、IntelliJ IDEA、Sublime等），选择你熟悉的键位绑定，可以极大降低学习成本。如果不确定，也可以稍后在设置中修改。

2. 初始设置

  • 设置AI回复语言：打开设置（Cmd/Ctrl + ,），搜索“Preferred Language”，将其设为“中文”。这样AI默认会用中文回答。也可以在对话中直接说“请用中文回答”，AI会记住本次会话的语言偏好。

  • 界面汉化：如果你希望界面为中文，可以安装“Chinese (Simplified) Language Pack”扩展，然后重启Cursor。注意：AI回复语言和界面语言是独立的。

  • 配置API密钥（可选）：Cursor本身提供免费额度（包括一定数量的快速请求和高级模型请求）。如果你有自己的OpenAI、Claude或Azure OpenAI密钥，可以在Cursor Settings中输入，使用自己的配额和模型。这对于需要更高容量或定制模型的场景很有用。

3. 首次体验

打开一个现有项目（比如你正在开发的项目），观察代码补全是否智能——它应该能基于项目中的已有代码提供补全建议。
试试 Ctrl+L（macOS：Cmd+L）打开聊天面板，输入“这个项目使用了哪些主要技术？”，看AI是否能正确识别。如果项目已经索引，它会给出比较准确的回答。

三、核心功能全景图

Cursor的核心功能可以归纳为以下几个维度：

功能 描述 常用入口
智能代码补全 基于整个工作区上下文，提供超越传统IDE的补全，甚至能预测下一步要写的代码 直接编码时自动触发
代码生成与修改 通过自然语言指令生成代码或修改选中代码 Ctrl+K（内联）、Ctrl+L（聊天）
代码解释与问答 选中代码，让AI解释其功能、潜在问题 右键菜单“Explain This”、Ctrl+L
项目级理解 索引整个代码库后，回答跨文件的问题 Ctrl+L 中提问，可配合@codebase
错误诊断与修复 粘贴编译错误或异常栈，AI分析原因并给出修复方案 聊天中粘贴错误信息
文档查询 内置常用框架文档，通过@docs快速查询 聊天或内联输入@docs 问题
代码库索引 扫描项目文件建立符号索引，让AI理解项目结构 自动进行，可手动触发

四、深度配置：Cursor Settings 与 Editor Settings

1. Cursor Settings（全局AI配置）

进入方式：Cmd/Ctrl + , → 选择“Cursor Settings”选项卡。

  • AI Model：选择使用的模型。推荐使用默认的“cursor-fast”（兼顾速度与质量）。若需要更高精度，可切换到GPT-4或Claude-3（消耗更多配额）。

  • Code Context：设置AI参考的代码上下文范围。

    • Current File：仅当前文件。

    • Open Tabs：当前打开的文件（推荐，兼顾性能和上下文）。

    • Workspace：整个项目（可能超出token限制，慎用）。

  • Auto-suggest：是否启用自动补全建议，以及触发方式。建议开启，若觉得干扰可改为手动触发。

  • Privacy：控制代码数据是否上传云端。对于敏感项目，可选择“Local Only”模式（需本地模型支持）或关闭数据上传。

  • Proxy：配置HTTP/HTTPS代理。

  • Telemetry：是否发送匿名使用数据帮助改进Cursor，可选。

2. Editor Settings（编辑器个性化）

进入方式：Settings → “Editor”选项卡。

  • Font Family / Font Size：推荐使用Fira Code、JetBrains Mono等连字字体。

  • Theme：选择深色或浅色主题，也可安装第三方主题。

  • Format on Save：保存时自动格式化代码，建议配合Prettier、Black等使用。

  • Files: Associations：自定义文件关联，如将.env文件关联为Properties语言。

  • Bracket Pair Colorization：启用括号对彩色化，便于阅读。

  • Word Wrap：是否自动换行。

  • Tab Size：设置制表符宽度（如2或4个空格）。

3. 扩展与插件管理

Cursor兼容VSCode的大部分插件。打开扩展市场（Ctrl+Shift+X），可以安装各种语言支持、主题、工具链插件。例如：

  • Python：安装Python扩展（微软官方）。

  • Java：安装“Extension Pack for Java”。

  • 前端：安装ESLint、Prettier等。

五、Java开发环境配置（以Spring Boot项目为例）

为了让Cursor正确识别Java项目结构、依赖，实现精准的AI辅助，需要配置Java开发环境。

详细步骤：

  1. 安装Java扩展：在扩展市场安装“Extension Pack for Java”（包含语言服务、调试器、Maven/Gradle支持）。

  2. 配置JDK：确保系统已安装JDK（推荐JDK 11或17），并在Cursor中设置java.configuration.runtimes。可以在settings.json中添加：

    "java.configuration.runtimes": [
    {
        "name": "JavaSE-11",
        "path": "/path/to/jdk-11",
        "default": true
    }
]

  3. 打开Maven/Gradle项目：直接打开项目根目录，Cursor会自动检测构建文件并下载依赖。等待依赖解析完成（状态栏有提示）。

  4. 等待索引完成：索引完成后，AI才能理解项目中的类、方法、字段关系。索引进度在状态栏可见。

  5. 验证：创建一个Controller，用Ctrl+K输入“生成一个REST接口，返回Hello World”，检查是否正确导入@RestController等注解。

常见问题：

  • 索引失败：尝试执行命令“Java: Clean Java Language Server Workspace”清理缓存。

  • 依赖解析慢：可配置Maven镜像或Gradle国内源。

六、快捷键大全：按开发工作流分类（专业完整版）

掌握快捷键能让你像专家一样流畅操作。以下按开发阶段分类，并标注使用频率（⭐⭐⭐⭐⭐为最高频）和实用技巧。

开发阶段 操作说明 Windows/Linux macOS 频率 使用技巧/场景
编码阶段 复制行向上/向下 Shift+Alt+↑ / ↓ Shift+Option+↑ / ↓ ⭐⭐⭐⭐ 无选中时复制整行，快速复制代码块
移动行向上/向下 Alt+↑ / ↓ Option+↑ / ↓ ⭐⭐⭐⭐ 调整代码顺序
删除行 Ctrl+Shift+K Cmd+Shift+K ⭐⭐⭐⭐ 快速删除整行
插入行在下方/上方 Ctrl+Enter / Ctrl+Shift+Enter Cmd+Enter / Cmd+Shift+Enter ⭐⭐⭐⭐ 在当前行下方/上方插入新行
添加行注释 Ctrl+/ Cmd+/ ⭐⭐⭐⭐⭐ 切换注释，用于快速调试
添加块注释 Shift+Alt+A Shift+Option+A ⭐⭐⭐ 用于多行注释
格式化文档 Shift+Alt+F Shift+Option+F ⭐⭐⭐⭐ 需安装格式化插件，保持代码风格一致
代码折叠/展开 Ctrl+Shift+[ / ] Cmd+Option+[ / ] ⭐⭐ 折叠/展开代码块，便于浏览长文件
自动修复（Quick Fix） Ctrl+. Cmd+. ⭐⭐⭐⭐ 显示错误/警告的快速修复选项，包括AI建议
多光标与选择 插入多个光标 Alt+点击 Option+点击 ⭐⭐⭐⭐ 批量编辑多行
在选中的每行末尾插入光标 Shift+Alt+I Shift+Option+I ⭐⭐⭐⭐ 适用于多行同时编辑，如添加分号
选择所有出现 Ctrl+F2 Cmd+F2 ⭐⭐⭐ 快速重命名变量/函数
添加下一个匹配 Ctrl+D Cmd+D ⭐⭐⭐⭐ 逐次选中相同单词，批量修改
列选择（矩形） Shift+Alt+拖动 Shift+Option+拖动 ⭐⭐⭐ 选择矩形区域，用于对齐编辑
导航与搜索 快速打开文件 Ctrl+P Cmd+P ⭐⭐⭐⭐⭐ 输入文件名/路径，支持模糊匹配
转到定义 F12 F12 ⭐⭐⭐⭐⭐ 跳转到变量/函数定义处
查看定义（预览） Alt+F12 Option+F12 ⭐⭐⭐ 悬浮窗口显示定义，不跳转
返回上一次位置 Alt+← Ctrl+- ⭐⭐⭐⭐⭐ 常用，类似浏览器后退
前进到下一次位置 Alt+→ Ctrl+Shift+- ⭐⭐⭐ 与返回对应
跳转到行 Ctrl+G Cmd+G ⭐⭐ 快速定位到某一行
跳转到符号 Ctrl+Shift+O Cmd+Shift+O ⭐⭐⭐⭐ 输入@符号，可加:过滤类型（类、方法）
全局查找 Ctrl+Shift+F Cmd+Shift+F ⭐⭐⭐⭐ 跨文件搜索，支持正则
在工作区查找符号 Ctrl+T Cmd+T ⭐⭐⭐ 搜索类、函数名，跨文件
打开最近文件 Ctrl+R Cmd+R ⭐⭐ 显示最近打开的文件列表
AI交互 打开聊天面板 Ctrl+L Cmd+L ⭐⭐⭐⭐⭐ 侧边栏对话，适合多轮交流
内联生成/修改 Ctrl+K Cmd+K ⭐⭐⭐⭐⭐ 最高频AI操作，务必熟记
打开独立聊天窗口 Ctrl+I Cmd+I ⭐⭐⭐ 适合临时小问题，不干扰侧边栏
解释选中代码 可自定义 可自定义 ⭐⭐⭐ 建议绑定快捷键，如 Ctrl+E
快速修复（AI建议） Ctrl+. Cmd+. ⭐⭐⭐⭐ 当有错误/警告时，显示AI修复选项
调试阶段 开始/继续调试 F5 F5 ⭐⭐⭐⭐
停止调试 Shift+F5 Shift+F5 ⭐⭐⭐
单步跳过 F10 F10 ⭐⭐⭐⭐
单步进入 F11 F11 ⭐⭐⭐⭐
单步跳出 Shift+F11 Shift+F11 ⭐⭐
切换断点 F9 F9 ⭐⭐⭐⭐
条件断点 右键点击断点 右键点击断点 ⭐⭐⭐ 设置条件，调试复杂逻辑
调试控制台 Ctrl+Shift+Y Cmd+Shift+Y ⭐⭐ 查看变量、执行表达式
重构与审查 重命名符号 F2 F2 ⭐⭐⭐⭐ 智能重命名，自动更新引用
提取方法/变量 Ctrl+Shift+R Cmd+Option+R ⭐⭐⭐ 通过命令面板触发，也可用快捷键
查看引用 Shift+F12 Shift+F12 ⭐⭐⭐ 显示所有引用位置
快速修复 Ctrl+. Cmd+. ⭐⭐⭐⭐ 也用于重构建议
窗口与视图 打开/关闭侧边栏 Ctrl+B Cmd+B ⭐⭐⭐⭐ 切换文件资源管理器等
拆分编辑器 Ctrl+\ Cmd+\ ⭐⭐⭐ 垂直拆分
切换编辑器组 Ctrl+1/2/3 Cmd+1/2/3 ⭐⭐ 数字对应第几个组
打开文件资源管理器 Ctrl+Shift+E Cmd+Shift+E ⭐⭐
打开搜索视图 Ctrl+Shift+F Cmd+Shift+F ⭐⭐
打开源代码管理 Ctrl+Shift+G Cmd+Shift+G ⭐⭐ Git面板
打开扩展市场 Ctrl+Shift+X Cmd+Shift+X ⭐⭐
终端操作 打开集成终端 Ctrl+| Cmd+ ⭐⭐⭐⭐
新建终端 Ctrl+Shift+| Cmd+Shift+ ⭐⭐
切换终端 Ctrl+PageUp/PageDown Cmd+PageUp/PageDown ⭐⭐
清空终端 右键点击 → 清除 右键点击 → 清除 ⭐⭐ 或输入 clear 命令
其他 打开命令面板 Ctrl+Shift+P Cmd+Shift+P ⭐⭐⭐⭐⭐ 执行任意命令，万能入口
打开设置 Ctrl+, Cmd+, ⭐⭐⭐
全屏 F11 Cmd+Ctrl+F ⭐

查看与自定义快捷键：命令面板输入“Keyboard Shortcuts”打开设置，可搜索命令并修改快捷键。建议将常用但未绑定的AI命令（如“Explain This”）绑定为易记组合键，如 Ctrl+E。

七、AI交互模式详解：Chat 与 Ctrl+K 的完美配合

Cursor提供了两种主要的AI交互模式，理解它们的适用场景能让你事半功倍。

1. Chat模式（Ctrl+L / Cmd+L）

  • 特点：打开侧边栏聊天面板，适合多轮对话、探索性任务。

  • 适用场景：

    • 讨论设计方案：“我想实现一个用户认证系统，你觉得用JWT还是OAuth2？”

    • 排查复杂问题：“这段代码为什么会内存泄漏？”（粘贴代码）

    • 学习新技术：“解释一下React的useEffect和useLayoutEffect的区别。”

    • 需求评审：“帮我审查这个接口设计，有没有安全漏洞？”

  • 优势：对话历史自动保存，可随时回顾；可以引用多个文件、符号。

2. 内联模式（Ctrl+K / Cmd+K）

  • 特点：在当前光标位置弹出输入框，生成或修改代码，操作流畅不离开编辑器。

  • 适用场景：

    • 快速生成代码片段：“写一个函数，计算两个日期之间的天数。”

    • 修改选中代码：“把这个函数改成异步的。”

    • 添加注释：“给这段代码添加详细注释。”

    • 重构小段代码：“用stream API重写这个循环。”

  • 优势：即写即用，效率极高；支持选中代码后直接修改。

3. 选择原则

  • 需要上下文讨论、探索性任务 → Chat。

  • 目标明确、只需生成/修改代码 → Ctrl+K。

  • 也可结合使用：在Chat中讨论方案，然后用Ctrl+K落地。

4. 聊天历史管理

点击聊天面板顶部的历史图标（时钟），可查看之前的对话，并可恢复继续对话。也可以删除不需要的历史记录。

八、高质量提示词工程：像专家一样与AI对话

作为专业开发者，我们需要掌握如何设计提示词，以获取最准确、最有用的输出。以下是提示词设计的原则和大量实战模板。

提示词设计原则

  • 明确角色：给AI设定一个专业角色，如“你是一位资深的Java架构师”、“你是一名安全专家”。

  • 限定范围：指定技术栈、框架版本、语言特性等。

  • 提供上下文：使用@引用相关文件、符号，或直接粘贴代码片段。

  • 指定输出格式：要求生成代码、JSON、Markdown、表格等。

  • 要求解释：让AI在给出代码的同时解释思路，便于学习。

  • 迭代优化：如果第一次输出不理想，可以进一步追问或修正指令。

  • 审计要求：对于关键代码，可要求AI进行自我审查，指出潜在问题。

分类实战模板（每个模板包含使用场景、示例、技巧）

（1）代码生成类

模板1：生成完整类/组件

  • 提示词：你是一位 [语言] 专家，请用 [框架] 创建一个 [组件类型]，实现 [功能描述]。要求符合 [规范]，包含必要的异常处理和日志，并给出使用示例。

  • 示例：你是一位Java专家，请用Spring Boot创建一个REST Controller，实现用户注册功能，包含参数校验、日志记录，返回统一格式的JSON响应。

  • 技巧：引用已有的实体类或工具类，让AI自动注入。

模板2：生成复杂算法

  • 提示词：实现一个 [算法名] 算法，输入 [描述输入]，输出 [描述输出]。要求时间复杂度 O(x)，并处理边界情况。请用 [语言] 编写，并附上单元测试。

  • 示例：实现一个LRU缓存，支持get和put操作，容量固定，要求get和put时间复杂度O(1)，用Java编写，并给出JUnit测试。

  • 技巧：可要求AI先解释算法思路，再生成代码。

模板3：生成配置文件

  • 提示词：请生成一个 [工具] 的配置文件，用于 [目的]。要求包含 [关键配置项]，并注释每个配置的作用。

  • 示例：请生成一个ESLint配置文件，用于React项目，要求使用Airbnb风格，并支持TypeScript。

  • 技巧：引用现有package.json，让AI自动检测依赖版本。

（2）代码解释与学习类

模板4：解释代码片段

  • 提示词：请解释以下代码的功能、输入输出、关键逻辑，并指出可能存在的性能问题或改进点。（后粘贴代码）

  • 示例：请解释这段Python代码的功能：def fib(n): return n if n<2 else fib(n-1)+fib(n-2)

  • 技巧：如果代码来自某个文件，用@引用，并指出行号。

模板5：学习新技术

  • 提示词：你是一位 [技术领域] 专家，请用通俗易懂的方式解释 [概念]，并给出一个简单的代码示例。

  • 示例：你是一位前端专家，请用通俗易懂的方式解释React Hooks中的useEffect，并给出一个计数器示例。

  • 技巧：可以要求对比其他类似概念。

（3）代码优化与重构类

模板6：优化代码性能

  • 提示词：请优化以下代码的性能，重点关注 [方面，如时间复杂度、内存使用]。给出优化后的代码，并解释优化思路。（粘贴代码）

  • 示例：请优化这段多重循环的代码，减少时间复杂度，用Java重写。

  • 技巧：可要求提供性能对比分析。

模板7：重构代码

  • 提示词：将以下代码重构为 [设计模式/更简洁的形式]，保持功能不变。请说明重构的好处。（粘贴代码）

  • 示例：将这段条件语句重构为策略模式，用Java实现。

  • 技巧：引用相关类，确保重构后代码能无缝集成。

（4）测试与调试类

模板8：生成单元测试

  • 提示词：为以下 [类/方法] 生成单元测试，使用 [测试框架]，覆盖所有分支和边界情况。（可引用代码或用@）

  • 示例：为UserService的register方法生成JUnit 5测试，覆盖成功注册、邮箱已存在、密码强度不足等场景。

  • 技巧：要求生成测试数据，或使用Mockito模拟依赖。

模板9：调试错误

  • 提示词：运行以下代码时出现错误：[错误信息]。请分析原因，并给出修复后的代码。（粘贴代码）

  • 示例：运行这段Python代码报错“KeyError: 'name'”，请修复。

  • 技巧：如果错误涉及项目配置，引用相关配置文件（如pom.xml、requirements.txt）。

（5）文档与注释类

模板10：生成文档注释

  • 提示词：为以下 [类/方法] 生成Javadoc/文档注释，说明功能、参数、返回值、异常，并附上使用示例。（可引用代码）

  • 示例：为这个工具类生成Javadoc，包括每个方法。

  • 技巧：可要求生成中英文双语文档。

模板11：生成README

  • 提示词：为这个项目生成README.md，包含项目简介、技术栈、安装步骤、运行方式、API文档（如果有）。（可引用项目文件）

  • 示例：为这个Spring Boot项目生成README.md，包含数据库配置说明。

  • 技巧：引用pom.xml和关键配置，让AI自动提取信息。

（6）安全审计类

模板12：代码安全审查

  • 提示词：你是一位安全专家，请审计以下代码，找出所有可能的安全漏洞（如SQL注入、XSS、CSRF、权限绕过），并给出修复建议。（粘贴代码）

  • 示例：审计这个登录接口，检查是否存在SQL注入或会话固定漏洞。

  • 技巧：可要求按照OWASP Top 10标准进行审查。

（7）迁移与升级类

模板13：框架迁移

  • 提示词：将以下 [旧框架] 代码迁移到 [新框架]，列出需要修改的关键点，并提供迁移后的代码示例。（可引用项目）

  • 示例：将这段Spring Boot 2.x的代码迁移到Spring Boot 3.x，注意javax到jakarta的变更。

  • 技巧：引用pom.xml，让AI自动分析依赖变化。

（8）数据库操作类

模板14：生成SQL/ORM操作

  • 提示词：使用 [ORM框架] 实现 [数据操作]，包括实体定义、Repository层、事务处理。

  • 示例：使用Spring Data JPA实现用户表的CRUD操作，并添加事务注解。

  • 技巧：引用现有实体类，保持字段一致。

（9）API设计与集成

模板15：设计REST API

  • 提示词：设计一个REST API用于 [功能]，包括端点、请求/响应格式、状态码，并给出OpenAPI 3.0描述。

  • 示例：设计一个订单管理的REST API，支持创建、查询、取消订单，使用OpenAPI 3.0格式。

  • 技巧：可要求生成对应的Controller代码。

（10）性能分析类

模板16：性能瓶颈分析

  • 提示词：分析以下代码的性能瓶颈，提出优化方案，并给出优化后的代码。（粘贴代码）

  • 示例：分析这个多重循环的性能瓶颈，提出优化方案，并重写。

  • 技巧：可要求用大O表示法分析时间复杂度。

（11）代码规范落地

模板17：根据规范重写代码

  • 提示词：根据以下编码规范重写这段代码：[规范文本]。确保代码符合规范要求。（粘贴代码）

  • 示例：根据Google Java Style重写这个类，包括命名、缩进、Javadoc。

  • 技巧：规范可以写入.cursorrules全局生效。

（12）复杂任务分解

模板18：将大任务拆解

  • 提示词：我需要实现 [复杂功能]，请帮我拆解成多个子任务，并给出每个子任务的实现要点。

  • 示例：我需要实现一个用户认证系统（注册、登录、JWT、权限控制），请拆解任务。

  • 技巧：后续可针对每个子任务用AI生成代码。

提示词组合技巧

  • 链式调用：先让AI设计方案，再让AI生成代码，最后让AI审查。

  • 角色叠加：你是一位Java架构师和DBA专家，请设计这个系统的数据库表结构，并生成对应的JPA实体。

  • 输出格式控制：请用Markdown表格形式列出所有API端点。

九、@符号深度解析：精准控制AI的上下文

@ 是Cursor中极其强大的上下文注入工具，能让AI精准理解你引用的内容。以下是所有支持的 @ 类型及用法。

1. @引用项目文件

  • 语法：@文件名 或 @路径/文件名

  • 示例：@UserService.java、@src/main/java/com/example/Hello.java

  • 作用：将指定文件的全部内容作为上下文。AI能读取文件中的所有代码、注释。

  • 使用场景：

    • 询问文件内容：“@UserService.java 这个类的主要功能是什么？”

    • 生成新代码时参考现有代码：“仿照@OldService.java 的写法，创建一个新服务。”

    • 调试时提供完整上下文：“@UserController.java 中的update方法报错，请分析。”

2. @引用符号（类、方法、变量）

  • 语法：@#符号名（如 @#UserService、@#findAll）

  • 作用：引用项目中特定的符号定义。AI会提取该符号的定义（包括其类型、签名、文档），但不会包含整个文件，节省上下文。

  • 使用场景：

    • 询问某个类的结构：“@#User 类有哪些字段？”

    • 生成调用代码：“调用 @#userRepository.save 方法保存用户。”

    • 分析依赖：“@#UserService 用到了哪些其他类？”

3. @引用整个代码库（codebase）

  • 语法：@codebase

  • 作用：将整个项目的索引作为上下文，AI可以回答涉及全局的问题，如“这个项目中哪里使用了多线程？”、“用户认证流程是怎样的？”

  • 注意：需要项目已完全索引，且可能消耗大量token，谨慎使用。

4. @引用文档（docs）

  • 语法：@docs 查询内容

  • 作用：查询Cursor内置的文档库，包括各种框架、库的官方文档。AI会检索相关文档并回答。

  • 示例：@docs Spring Boot 如何配置多数据源？

  • 支持文档：目前支持大量流行框架，如React、Vue、Spring、Django等。可在命令面板中查看完整列表。

  • 使用场景：快速查阅API用法，无需离开编辑器。

5. @引用网页（web）

  • 语法：@web 查询内容

  • 作用：让AI联网搜索最新信息，如“@web 2024年最新的Java趋势”。需要Cursor处于在线状态，且可能消耗额外配额。

  • 使用场景：查询实时信息、最新库版本、技术新闻等。

6. @引用Git提交/分支（git）

  • 语法：@git <commit-hash> 或 @git <branch-name>

  • 作用：引用特定Git提交或分支的代码变更，AI可以分析diff、总结修改。

  • 示例：@git main 对比当前分支，有哪些主要变化？

  • 使用场景：代码审查、生成提交信息、分析冲突。

7. @引用当前选择（selection）

  • 语法：@selection（在Chat中，如果已选中代码，可输入此指令）

  • 作用：引用当前选中的代码片段，等同于粘贴。

  • 使用场景：在Chat中解释或修改选中的代码。

8. @引用终端输出（terminal）

  • 语法：@terminal（需终端有输出）

  • 作用：引用最近终端输出的内容，如错误日志。

  • 示例：@terminal 这个错误是什么意思？

9. @组合使用

  • 可以同时引用多个项目，如 @UserController @UserService 请分析它们之间的依赖关系。

  • 也可以与普通文本混合，如 请参考 @UserService 的写法，为 @UserController 添加日志。

10. @使用技巧与注意事项

  • 优先使用符号引用而非文件引用，以节省上下文token。

  • 对于大型文件，引用整个文件可能超出模型限制，建议只引用关键部分。

  • 如果引用多个文件，注意上下文总长度，必要时只保留核心。

  • @codebase 慎用，因为它会消耗大量token，可能导致后续对话受限。

  • @docs 和 @web 需要网络，且可能受模型限制，有时不如直接Google。

十、代码库索引：让AI真正理解你的项目

索引的原理

Cursor会扫描项目中的文件，建立符号表、依赖关系、调用图等，存储在本地索引中。索引后，AI才能回答跨文件的问题、准确生成符合项目结构的代码。

如何触发索引

  • 自动索引：打开项目后自动开始，状态栏显示“Indexing...”。

  • 手动触发：右键项目根目录 → “Reindex Project”。

  • 增量索引：当文件修改时，会自动更新。

查看索引状态

点击状态栏的索引指示器，可查看进度、暂停或重新索引。

优化索引性能：.cursorignore 文件详解

作用

类似于.gitignore，用于告诉Cursor在索引时忽略某些文件或文件夹，以减少索引负担、加快速度，并避免将敏感文件纳入上下文。

配置位置

在项目根目录创建 .cursorignore 文件。

语法

每行一个忽略模式，支持glob通配符（如 *、**、?、[abc]）。空行或以 # 开头的行会被忽略。

常用模式示例

# 忽略node_modules目录
node_modules/

# 忽略所有构建输出目录
dist/
build/
target/

# 忽略所有日志文件
*.log

# 忽略特定文件
secrets.json
.env

# 忽略所有隐藏文件（以点开头）
.*

# 但保留某些隐藏文件（取反）
!.gitignore
!.cursorrules
最佳实践

  • 至少忽略 node_modules、target、build、dist 等依赖和输出目录。

  • 忽略包含敏感信息的文件（如 .env、密钥文件）。

  • 忽略大型二进制文件（如图片、视频）。

  • 使用 ! 模式保留必要的隐藏文件（如 .gitignore、.cursorrules）。

  • 定期审查 .cursorignore，确保没有遗漏重要文件。

注意事项

被忽略的文件不会出现在AI上下文中，也不会用于代码补全和索引。如果AI需要引用这些文件，需手动用@引用，但可能因忽略而无法读取。

索引失败处理

  • 如果索引长时间卡住，尝试执行“Developer: Reload Window”重启。

  • 清理索引缓存：命令面板输入“Indexing: Rebuild Index”。

  • 检查是否被安全软件拦截，或磁盘空间不足。

  • 检查 .cursorignore 是否误将关键文件忽略。

索引生效后的能力

  • 跨文件问答：“这个项目中哪里定义了数据库连接池？”

  • 代码生成时自动导入项目内已有工具类。

  • 重构时识别所有引用，确保安全。

十一、Rules规则：让AI遵循团队编码规范

什么是Rules

Rules定义了AI生成代码的行为准则，相当于给AI一份“编码规范文档”。规则可以是简单的命名约定，也可以是复杂的架构约束。

两种作用域

  1. 工作空间规则（项目级）：在项目根目录创建 .cursorrules 文件，仅对当前项目生效。适用于团队共享的规范。

  2. 个人规则（全局）：在Cursor Settings中找到“Rules”输入框，写入全局规则，应用于所有项目。适用于个人偏好或全局标准。

优先级关系

  • 工作空间规则覆盖个人规则：当项目存在 .cursorrules 时，其规则将覆盖个人规则中的冲突部分；如果个人规则中有而工作空间规则未定义，则个人规则仍生效。

  • 具体行为：Cursor会合并两者，但工作空间规则的优先级更高。建议将项目特定规范放在 .cursorrules，将通用偏好（如缩进大小）放在个人规则。

规则编写最佳实践

  • 从简单开始：先定义缩进、命名、注释等基本规则。

  • 逐步细化：根据团队实际需求，添加框架偏好、禁止API、日志规范等。

  • 使用自然语言：AI能理解自然语言，所以规则可以写成：“使用4个空格缩进，类名使用UpperCamelCase，方法名使用lowerCamelCase。”

  • 结构化格式示例（YAML）：

    
# 编码风格
indent_size: 4
use_tabs: false
line_length: 120
# 命名规范
class_naming: UpperCamelCase
method_naming: lowerCamelCase
constant_naming: UPPER_SNAKE_CASE
# 注释要求
require_javadoc: public, protected
todo_format: "TODO: [姓名] - [日期] - [描述]"
# 框架偏好
java_framework: Spring Boot
orm: Spring Data JPA
# 禁止API
forbidden_apis:
  - java.util.Date (use java.time.*)
  - System.out.println (use SLF4J Logger)
# 安全规范
security:
  - avoid_sql_injection: use prepared statements
  - validate_all_user_inputs
# 异常处理
exception_handling: use custom exceptions for business errors
# 日志要求
logging: use SLF4J with log levels (info for normal flow, debug for details)

规则生效验证

生成一段代码，检查是否符合规则。例如，如果规则禁止使用System.out.println，生成的代码应使用Logger。

调试规则

  • 若AI未遵守，可检查规则文件格式是否正确（如YAML缩进错误）。

  • 在提示词中强调“请遵循.cursorrules中的规则”。

  • 尝试重启Cursor，确保规则重新加载。

  • 检查工作空间规则和个人规则是否有冲突。

团队共享规则

将 .cursorrules 加入版本控制，团队所有成员共享一套AI行为准则。

十二、Cursor Docs功能详解：内置文档查询

什么是Cursor Docs

Cursor内置了常用框架和库的文档，可以通过 @docs 快速查询，无需切换窗口。

如何使用

  • 在Chat或Ctrl+K中输入 @docs 你的问题，如 @docs React useState 用法。

  • 也可以在命令面板中搜索“Docs: Search”打开文档面板。

支持哪些文档

目前包括React、Vue、Angular、Spring、Django、Flask、Express、Next.js、Nuxt、Tailwind CSS等。可在设置中查看完整列表或请求添加。

使用场景

  • 快速查找API用法，如 @docs Spring Boot @RequestBody 注解。

  • 比较不同框架的差异，如 @docs React vs Vue 生命周期。

  • 学习新库时，用 @docs 查询概念。

技巧

如果 @docs 返回的结果不够准确，可以尝试加上更具体的关键词，或改用 @web 搜索最新信息。

十三、实战演练：从零开发一个Spring Boot + React全栈应用

通过一个完整项目，串联所有知识点，展示Cursor如何贯穿开发全流程，大幅提升效率。

项目需求

开发一个简单的任务管理应用（Task Manager），后端用Spring Boot，前端用React，数据库用MySQL。

阶段1：项目初始化

  • 后端初始化：用Chat询问“如何创建一个Spring Boot项目，使用Maven，包含web、jpa、mysql依赖？” AI给出pom.xml内容和主类。用Ctrl+K在pom.xml中快速插入依赖。

  • 前端初始化：用Chat询问“如何用Create React App创建一个React项目？” AI给出命令。在终端执行命令，或用Ctrl+`快速打开终端。

阶段2：数据库设计

  • 在Chat中问：“设计任务表，包含id、标题、描述、状态、创建时间、截止时间，状态用枚举。” AI给出SQL建表语句。

  • 用Ctrl+K生成对应的JPA实体类，引用SQL语句。

  • 设置Rules确保实体类命名规范（如使用@Entity、@Table等）。

阶段3：后端开发

  • Repository层：Ctrl+K输入“创建JPA Repository接口，提供根据状态查询任务的方法”，引用Task实体。

  • Service层：Chat中引用TaskRepository，要求“生成TaskService，包含增删改查方法，添加事务注解和日志”。

  • Controller层：Ctrl+K输入“创建REST Controller，提供任务列表、详情、创建、更新、删除接口，返回统一响应格式”。使用@引用TaskService，让AI自动注入。

  • 测试：为Service方法生成单元测试，用Ctrl+K选中方法，输入“生成JUnit测试，使用Mockito”。

阶段4：前端开发

  • API服务：在Chat中引用后端的Controller，要求“根据这个Controller生成前端的API调用服务（使用axios）”。

  • 组件开发：用Ctrl+K生成任务列表组件、表单组件，引用API服务。

  • 状态管理：用Chat询问“如何在React中管理任务列表状态？” AI给出useState或useReducer示例。

  • 样式：用@docs查询Tailwind CSS用法，快速添加样式。

阶段5：联调与调试

  • 运行前后端，遇到跨域问题，用Chat粘贴错误信息，AI给出解决方案（如添加@CrossOrigin注解）。

  • 前端调用API失败，用@web搜索axios拦截器用法，添加统一错误处理。

阶段6：部署准备

  • 用Chat生成Dockerfile，分别用于前后端。

  • 用@docs查询如何配置nginx反向代理。

  • 生成README.md，包含项目介绍、技术栈、部署步骤。

全程亮点

频繁使用快捷键、@引用、提示词模板和Rules，保持代码风格一致，快速迭代。

十四、常见问题与解决方案

Q1: AI生成的代码不符合项目规范怎么办？

  • 检查是否配置了.cursorrules，并确保规则正确。

  • 在提示词中明确要求遵循规则，或提供示例代码让AI模仿。

Q2: 索引一直卡住怎么办？

  • 尝试重启Cursor，或执行“Indexing: Rebuild Index”。

  • 检查.cursorignore是否误将重要文件排除。

  • 排除不必要的文件夹，减少索引负担。

  • 检查项目是否有损坏的文件（如超大文件、二进制文件）。

Q3: AI回答上下文超限（token超长）

  • 减少引用的文件数量，优先用符号引用。

  • 在Chat中分割问题，分步询问。

  • 使用@codebase要谨慎，必要时先让AI总结关键部分。

Q4: AI不理解我的项目结构

  • 确保项目已完全索引，且未在.cursorignore中排除关键文件。

  • 在提示词中用@明确引用相关文件。

  • 重新索引项目。

Q5: 如何让AI生成更安全的代码？

  • 在Rules中添加安全规范，如禁止SQL拼接。

  • 在提示词中要求进行安全审计。

  • 使用@docs查询安全最佳实践。

Q6: Cursor的免费额度用完了怎么办？

  • 可以购买付费套餐，或绑定自己的API密钥。

  • 优化提示词，减少不必要的请求。

  • 使用本地模型（如通过Ollama）作为替代。

Q7: 工作空间规则和个人规则冲突时以哪个为准？

  • 工作空间规则优先级更高，会覆盖个人规则中的冲突部分。

  • 建议将项目特有规范放在工作空间，通用偏好放在个人规则。

Q8: .cursorignore 和 .gitignore 有何区别？

  • .cursorignore 只影响Cursor索引，不影响版本控制。

  • 可以独立于.gitignore，但通常建议复制.gitignore的忽略规则，并添加Cursor特定忽略。

十五、进阶技巧与扩展

1. 自定义AI模型

如果你有自己的私有模型，可以通过API集成到Cursor中，实现完全本地化。在Cursor Settings中配置OpenAI兼容的API端点即可。

2. 使用本地模型

Cursor支持连接Ollama、LM Studio等本地推理服务，适合对数据隐私要求高的场景。在设置中配置本地服务的URL即可。

3. 与CI/CD集成

利用Cursor的CLI工具（如果有）在CI中自动审查代码。目前Cursor尚未提供官方CLI，但可以通过脚本调用其API实现类似功能。

4. 编写自定义命令

通过Cursor的扩展API（如果开放）编写插件，扩展AI能力。目前Cursor支持VSCode插件，你可以开发自己的扩展来增强功能。

5. 快捷键脚本

使用AutoHotkey（Windows）或Karabiner（macOS）自定义系统级快捷键，一键触发Cursor命令。例如，设置全局快捷键Ctrl+Alt+K，模拟在Cursor中按下Ctrl+K。

6. 团队模板库

建立团队共享的提示词模板库，新人快速上手。可以将模板写在.cursorrules中，或单独存放为Markdown文件，需要时复制。

7. 结合Git工作流

  • 在提交前用AI审查代码变更：将git diff输出粘贴到Chat，要求“审查这些变更，指出潜在问题”。

  • 生成提交信息：粘贴git diff --cached，要求“根据这些变更生成规范的提交信息”。

十六、总结与学习资源

Cursor的核心优势

将AI无缝融入开发环境，让开发者专注于高价值设计，减少机械编码。通过本文的学习，你应该已经掌握了：

  • 快捷键与高效操作

  • 提示词工程与@引用

  • 代码库索引与.cursorignore

  • Rules规则配置

  • 内置文档查询

  • 实战全流程

学习路径建议

  1. 入门：先从快捷键和基本AI交互入手，逐步熟悉。

  2. 进阶：积累个人提示词模板库，提升效率。

  3. 精通：深入研究Rules和@引用，实现个性化AI助手。

  4. 扩展：关注Cursor官方更新，新功能往往能进一步提效。

推荐资源

  • 官方文档：cursor.sh/docs（必读）

  • Discord社区：discord.gg/cursor（交流技巧、反馈问题）

  • YouTube教程：搜索“Cursor AI tutorial”获取视频教程

  • GitHub示例：搜索“cursor-ai-examples”获取灵感

最后提醒

AI是助手，不是替代品。始终审查生成的代码，确保其正确性和安全性。Cursor能帮你节省大量时间，但最终的决策和责任仍在开发者手中。

祝你在Cursor的陪伴下，编程效率飞升，享受创造的乐趣！

Logo
2048 AI社区

有“AI”的1024 = 2048，欢迎大家加入2048 AI社区

更多推荐

cover

大模型已经进化到这个地步了？我花了一周时间实测，结果让我震惊

avatar 2048 AI社区

ComfyUI AI漫剧工业化量产技术方案｜基于FLUX+Wan2.2本地二次元短剧全链路落地教程

本文介绍了一套基于本地ComfyUI的AI漫剧工业化生产方案，重点解决当前AI视频创作中的人设变脸、画风混乱、水印限制等核心痛点。该方案采用FLUX二次元模型+Wan2.2动态模型组合，通过分镜生成、人设锁定、批量渲染等标准化流程，实现8G显卡即可稳定量产高质量连载漫剧。关键创新包括：1）IP-Adapter固定人设参数；2）短镜头分段生成策略；3）专用二次元提示词体系；4）自动化量产脚本。配套资

avatar 2048 AI社区

一边语音聊天，一边让 Agent 干活：最火爆的 7 个 Voice Coding Agent 大盘点丨Voice Agent 学习笔记

桌面上的 SKI、Qwen-Audio-Agent、Zoku 还假设人至少在电脑附近，拥有 4G 网络的 Disbrief 则把同样的问题带到了走路、通勤和离开屏幕之后：多个 Agent 继续在后台工作，人通过语音保持联系。前台的对话不断流动，后台的任务也在持续推进，两者同时发生，却互不阻塞。，做法很直接：不自己做 Coding Agent，而是连接 Claude Code、Codex、Curso

avatar 2048 AI社区