Cursor 使用手册精简指南Cursor 使用手册精简指南。Cursor 是一款基于 VS Code 内核开发的智能代

Cursor 使用手册精简指南

一. Cursor 简介

Cursor 是一款基于 VS Code 内核开发的智能代码编辑器，深度集成 AI 功能（如 GPT-4 和 Claude 3），支持代码生成、自然语言对话、代码解释与调试等，显著提升开发效率。

二. 安装与配置

安装步骤

访问 Cursor 官网下载对应系统版本(安装、使用全程需要科学上网)
安装完成后，打开 Cursor
（可选）登录账号以同步设置和模型偏好

三. 核心功能

1. Tab 编程（补全式协作）

Tab 编程是 Cursor 最自然的 AI 协作方式，在你编写代码时，AI 会实时提供智能补全建议。

使用步骤

开始编写代码：在编辑器中正常输入代码，AI 会自动分析上下文
查看补全建议：当 AI 检测到可以补全的代码时，会在光标后显示灰色预览文本
接受补全：
- 按 Tab 键接受当前补全建议
- 按 Esc 键拒绝补全建议
- 继续输入会取消当前补全建议
调整补全内容：如果补全不完全符合需求，可以：
- 部分接受后手动修改
- 拒绝后重新输入，触发新的补全建议

适用场景

编写函数实现时，AI 根据函数名和参数自动补全逻辑
编写 API 调用时，自动补全请求参数和错误处理
编写组件时，根据组件名自动补全结构
编写测试用例时，根据函数签名自动生成测试代码

最佳实践

保持代码上下文清晰，有助于 AI 生成更准确的补全
使用有意义的变量名和函数名，提升补全质量
对于复杂逻辑，可以先用注释描述需求，再让 AI 补全实现

2. 内联编辑（选中文本 → AI 重写）

内联编辑允许你选中已有代码，让 AI 根据你的指令进行重写、优化或修改。

使用步骤

选中代码：在编辑器中选中需要修改的代码块（可以是单行、多行或整个函数）
触发内联编辑：
- 按 Ctrl/Cmd + K 打开内联编辑工具
- 或者选中代码后，右键选择 "Ask AI" 或 "Edit with AI"
输入修改指令：在弹出的输入框中输入你的需求，例如：
- "优化这段代码的性能"
- "将这段代码改为使用 async/await"
- "添加错误处理逻辑"
- "重构为更简洁的实现"
审阅生成结果：AI 会生成修改后的代码，你可以：
- 点击 "Accept" 接受全部修改
- 点击 "Reject" 拒绝修改
- 点击 "Modify" 继续输入新的修改要求
- 手动编辑生成的代码后再接受
迭代优化：如果不满意，可以继续使用 Ctrl/Cmd + K 输入新的修改指令

适用场景

代码重构：将旧代码改写为更现代的写法
性能优化：优化算法或数据结构
添加功能：在现有代码基础上添加新功能
修复 Bug：根据错误信息修复代码问题
代码风格统一：将代码改为符合项目规范

最佳实践

指令要具体明确，避免模糊的描述
可以分步骤进行多次修改，每次专注于一个方面
修改后务必测试，确保功能正常

3. Agent 编程（多步骤自动化）

Agent 编程是 Cursor 的高级功能，AI 可以自动执行多个步骤来完成复杂任务，如创建文件、修改多个文件、运行命令等。

使用步骤

打开聊天窗口：按 Ctrl/Cmd + L 打开 AI 聊天窗口
描述复杂任务：输入需要完成的复杂任务，例如：
- "创建一个完整的用户登录功能，包括前端页面、API 接口和数据库模型"
- "为项目添加单元测试，覆盖所有核心功能"
- "重构整个组件，将其拆分为多个子组件"
AI 自动规划：AI 会分析任务，自动规划执行步骤
查看执行计划：AI 会显示将要执行的操作列表，你可以：
- 点击 "Approve" 批准执行
- 点击 "Modify" 修改计划
- 点击 "Cancel" 取消任务
自动执行：批准后，AI 会自动：
- 创建或修改文件
- 执行必要的命令
- 更新相关配置
查看执行结果：AI 会显示执行摘要，包括：
- 创建或修改的文件列表
- 执行的命令
- 遇到的问题和解决方案
验证和调整：检查生成的结果，如有需要可以继续提出修改要求

适用场景

创建新功能模块：从零开始创建完整的功能
项目初始化：搭建新项目的目录结构和基础代码
代码迁移：将代码从一个框架迁移到另一个框架
批量修改：同时修改多个相关文件
添加测试：为现有代码添加完整的测试套件

最佳实践

任务描述要详细，包括技术栈、文件结构等要求
使用 @ 符号关联相关文件，提供更多上下文
分阶段执行复杂任务，先完成核心功能，再逐步完善
执行前仔细审查 AI 的计划，确保符合预期

4. Rules 的使用

Rules 是 Cursor 的规则配置功能，可以定义项目的代码风格、技术栈偏好、开发规范等，确保 AI 生成的代码符合项目要求。

使用步骤

生成 Rules 文件：

按 Ctrl/Cmd + L 打开 AI 聊天窗口
输入以下指令（根据你的项目调整）：

帮我根据当前代码的风格生成一个web前端、vue3+element plus技术栈的Cursor中的Rules规则文件，能够让我们的项目按照现代化规范流程进行功能实现，请尽可能的完整

AI 会生成 .cursorrules 文件内容

创建 Rules 文件：
- 在项目根目录创建 .cursorrules 文件
- 或者创建 .cursor/rules 目录，在其中创建 .mdc 格式的规则文件
配置 Rules：
- 打开 Cursor 设置（Ctrl/Cmd + ,）
- 搜索 "Rules" 或 "Cursor Rules"
- 在规则配置界面：
- 创建新的规则文件（.mdc 格式）
- 将生成的 rules 内容拷贝到文件中
- 填写规则描述（便于识别和管理）
- 配置规则生效范围： * 项目级别：仅当前项目生效 * 全局级别：勾选全局选项，所有项目生效
自定义 Rules：根据项目需求修改规则内容，可以包括：
- 代码风格规范（缩进、命名等）
- 技术栈偏好（框架、库的选择）
- 项目结构规范（目录组织方式）
- 开发流程要求（测试、文档等）
验证 Rules：在聊天窗口或代码生成时，AI 会自动遵循配置的 Rules

Rules 配置示例

# Vue3 + Element Plus 项目规范

## 技术栈
- 使用 Vue 3 Composition API
- 使用 `<script setup>` 语法
- 使用 Element Plus UI 组件库
- 使用 TypeScript
- 使用 Pinia 进行状态管理

## 代码规范
- 组件名使用 PascalCase
- 变量和函数使用 camelCase
- 常量使用 UPPER_SNAKE_CASE
- 使用 2 空格缩进
- 单引号用于字符串

## 组件结构
- 使用 Composition API
- 按需导入 Element Plus 组件
- 添加 TypeScript 类型定义
- 包含必要的注释

适用场景

团队协作：统一团队的代码风格和开发规范
项目规范：确保新代码符合项目架构要求
技术栈约束：限制 AI 使用的技术栈和库
代码质量：定义代码质量标准和要求

最佳实践

根据项目实际情况定制 Rules，不要盲目使用模板
定期更新 Rules，随着项目演进调整规范
在团队中共享 Rules 配置，保持一致性
为不同项目配置不同的 Rules

5. MCP 的使用

MCP（Model Context Protocol）是 Cursor 的扩展协议，允许你连接外部工具和服务，扩展 AI 的能力范围。

使用步骤

了解 MCP 功能：
- MCP 可以连接各种外部服务，如数据库、API、文件系统等
- 通过 MCP，AI 可以访问和操作这些外部资源
配置 MCP 服务器：
- 打开 Cursor 设置（Ctrl/Cmd + ,）
- 搜索 "MCP" 或 "Model Context Protocol"
- 在 MCP 配置中添加服务器连接
使用 MCP 工具：
- 在聊天窗口中，输入 @ 符号
- 选择可用的 MCP 工具或资源
- 或者在聊天中直接描述需要使用 MCP 工具的任务
常见 MCP 工具示例：
- 文件系统 MCP：访问和操作文件系统
- 数据库 MCP：连接数据库并执行查询
- API MCP：调用外部 API 服务
- Git MCP：执行 Git 操作
- Figma MCP：访问 Figma 设计文件
- Notion MCP：操作 Notion 数据库和页面

MCP 使用示例

示例 1：使用文件系统 MCP

在聊天窗口输入：
"使用文件系统 MCP 列出项目中的所有 .vue 文件"

示例 2：使用数据库 MCP

在聊天窗口输入：
"使用数据库 MCP 查询用户表中最近注册的 10 个用户"

示例 3：使用 Figma MCP

在聊天窗口输入：
"使用 Figma MCP 获取设计文件的组件信息，并生成对应的 Vue 组件代码"

配置 MCP 服务器

MCP 服务器通常需要配置文件，位置可能在：

~/.cursor/mcp.json（全局配置）
项目根目录的 .cursor/mcp.json（项目配置）

配置示例：

{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args": ["path/to/mcp-server.js"]
    },
    "database": {
      "command": "python",
      "args": ["path/to/db-mcp-server.py"],
      "env": {
        "DB_URL": "postgresql://localhost/mydb"
      }
    }
  }
}

适用场景

访问外部数据：从数据库、API 获取数据用于代码生成
文件操作：批量处理文件、生成文件结构
设计转代码：从 Figma 设计文件生成代码
文档管理：与 Notion、Confluence 等文档系统集成
版本控制：执行 Git 操作，管理代码版本

最佳实践

根据需要选择合适的 MCP 工具
确保 MCP 服务器配置正确，权限设置合理
注意数据安全，避免在 MCP 中暴露敏感信息
定期检查 MCP 工具的输出，确保准确性

快捷键参考

快捷键	功能
Ctrl/Cmd + K	内联编辑（选中代码后）
Ctrl/Cmd + L	打开 AI 聊天窗口
Tab	接受 AI 补全建议
Esc	拒绝 AI 补全建议
Ctrl/Cmd + /	注释/取消注释代码
Ctrl/Cmd + Shift + R	重构选中代码
Ctrl/Cmd + Shift + F	全项目搜索
Alt + Z	自动换行

四. 最佳实践

高效需求描述

示例一：明确需求 + 技术栈 + 期望实现

请使用 Vue3 和 Element Plus 实现一个用户管理页面，包含以下功能：
顶部搜索区域：支持按用户名、手机号和状态筛选
中间表格区域：展示用户列表，包含ID、用户名、手机号、创建时间和状态字段
分页功能：底部添加分页，每页显示10条记录
操作按钮：每行末尾有编辑和删除按钮
要求：
- 响应式设计，适配不同屏幕尺寸
- 使用 Composition API 和 <script setup> 语法
- 表格数据需要从后端 API 获取，使用 axios
- 请处理加载状态和错误情况

示例二：具体技术问题 + 上下文 + 示例代码

我在开发一个 Spring Boot 应用时遇到问题，需要实现一个文件上传功能，将上传的 Excel 文件解析成对象列表。

已有代码：
@RestController
@RequestMapping("/api/upload")
public class UploadController {
    @PostMapping("/excel")
    public ResponseEntity<String> uploadExcel(@RequestParam("file") MultipartFile file) {
        // 需要在这里实现解析Excel的功能
    }
}

请帮我完善这段代码，要求：
1. 使用 Apache POI 库解析 Excel 文件（.xlsx格式）
2. 将每行数据解析为 User 对象（User 类有 id, name, age, email 字段）
3. 处理可能的异常情况，如文件为空、格式不正确等
4. 返回解析成功的记录数和失败的记录数

示例三：功能改进 + 现有代码 + 业务逻辑

我需要在现有的购物车模块中添加优惠券功能。当前的购物车类如下：
class ShoppingCart {
    constructor() {
        this.items = [];
        this.totalPrice = 0;
    }

    addItem(product, quantity) {
        // 添加商品到购物车
        const item = { product, quantity };
        this.items.push(item);
        this.calculateTotal();
    }

    calculateTotal() {
        this.totalPrice = this.items.reduce((sum, item) =>
            sum + item.product.price * item.quantity, 0);
    }
}
请帮我扩展这个类，添加以下功能：
1. 添加应用优惠券的方法，支持两种类型：
   - 固定金额优惠券（如：减50元）
   - 百分比折扣优惠券（如：85折）
2. 优惠券可能有使用条件，如购物满200元才能使用
3. 添加一个获取最终价格的方法，考虑优惠券折扣
4. 需要处理优惠券不满足条件等异常情况

高效需求描述要点

明确技术栈：指定框架、库和语法偏好
提供上下文：展示现有代码或系统架构
详细功能描述：清晰列出每个需求点
指定输入输出：明确说明期望的结果格式
设定边界条件：提及需要处理的异常情况
使用结构化格式：使用编号列表、代码块等清晰组织信息
提供具体示例：给出输入示例和期望输出
指明业务规则：解释特定的业务逻辑和约束

其他最佳实践

迭代优化：通过多次对话调整生成结果（如"添加错误处理逻辑"）
隐私保护：敏感代码建议关闭 AI 训练数据同步（设置 → 关闭 Telemetry）
上下文管理：每次新需求时，使用 @ 重新选择相关文件作为上下文
保存会话：重要的 AI 会话可保存为文件，便于日后查阅和继续

五. cursor的其他配置

1. 模型选择

Cursor 支持多种 AI 模型，可以根据不同场景选择合适的模型以获得最佳效果。

配置步骤

打开模型设置：
- 打开 Cursor 设置（Ctrl/Cmd + ,）
- 搜索 "Model" 或 "AI Model"
- 或者点击聊天窗口右上角的模型选择按钮
选择模型：在模型列表中可以选择：
- Claude 3.5 Sonnet：适合复杂推理和代码生成
- Claude 3 Opus：适合需要深度理解的任务
- GPT-4：适合通用编程任务
- GPT-4 Turbo：速度更快，适合快速迭代
- GPT-3.5 Turbo：轻量级任务，响应更快
配置模型偏好：
- 为 Tab 补全设置默认模型（通常选择响应快的模型）
- 为聊天对话设置默认模型（可以选择能力更强的模型）
- 为内联编辑设置默认模型
切换模型：
- 在聊天窗口中，点击输入框上方的模型名称可以快速切换
- 不同模型有不同的特点，可以根据任务需求灵活选择

模型选择建议

代码补全（Tab 编程）：选择响应速度快的模型，如 GPT-3.5 Turbo 或 GPT-4 Turbo
复杂代码生成（Agent 编程）：选择能力强的模型，如 Claude 3.5 Sonnet 或 GPT-4
代码重构和优化：选择理解能力强的模型，如 Claude 3 Opus
快速迭代开发：选择响应快的模型，如 GPT-4 Turbo

模型配置位置

设置路径：File → Preferences → Settings → Cursor → Model
配置文件：~/.cursor/settings.json（全局）或项目根目录 .vscode/settings.json（项目级）

2. 文档配置

文档配置允许你指定哪些文件应该被 AI 读取作为上下文，以及如何管理文档索引。

配置步骤

打开文档设置：
- 打开 Cursor 设置（Ctrl/Cmd + ,）
- 搜索 "Documentation" 或 "Index"
配置索引文件：
- 包含文件模式：指定哪些文件应该被索引（如 *.md, *.txt, docs/**）
- 排除文件模式：指定哪些文件不应该被索引（如 node_modules/**, *.log）
- 最大文件大小：设置索引文件的最大大小限制
配置上下文窗口：
- 自动包含相关文件：开启后，AI 会自动包含相关的文件作为上下文
- 上下文文件数量限制：设置每次对话最多包含的文件数量
- 上下文大小限制：设置上下文的总大小限制（token 数）
管理文档索引：
- 在设置中可以手动触发重新索引
- 查看当前已索引的文件列表
- 清除索引缓存

使用 @ 符号引用文档

在聊天窗口中使用 @ 符号可以显式引用特定文件或文档：

引用文件：
- 在聊天窗口输入 @，会显示文件列表
- 选择要引用的文件，AI 会将其作为上下文
- 可以同时引用多个文件
引用文件夹：
- 使用 @文件夹名 可以引用整个文件夹
- 适用于需要大量上下文的大型任务
引用代码片段：
- 选中代码后，在聊天窗口会自动包含选中内容
- 或者使用 @代码片段 手动引用

文档配置示例

{
  "cursor.indexing.include": [
    "**/*.md",
    "**/*.txt",
    "docs/**",
    "README.md"
  ],
  "cursor.indexing.exclude": [
    "node_modules/**",
    "dist/**",
    "*.log",
    ".git/**"
  ],
  "cursor.context.maxFiles": 20,
  "cursor.context.maxTokens": 100000
}

最佳实践

只索引必要的文档，避免索引过多文件导致性能下降
定期清理不需要的索引文件
使用 .cursorignore 文件排除不需要索引的文件（类似 .gitignore）
对于大型项目，使用文件夹引用而不是引用整个项目

3. Commands 配置

Commands（命令）是 Cursor 的自定义命令功能，允许你创建可重复使用的 AI 指令模板。

创建自定义命令

打开命令配置：
- 打开 Cursor 设置（Ctrl/Cmd + ,）
- 搜索 "Commands" 或 "Custom Commands"
- 或者使用快捷键 Ctrl/Cmd + Shift + P，输入 "Cursor: Add Command"
创建新命令：
- 点击 "Add Command" 或 "+" 按钮
- 输入命令名称（如 "生成单元测试"）
- 输入命令描述（可选）
- 输入命令提示词（这是 AI 执行的指令）
配置命令参数：
- 可以在提示词中使用变量，如 {{file}}、{{selected}} 等
- 支持多个参数，让命令更灵活
保存命令：保存后，命令会出现在命令面板中

使用自定义命令

通过命令面板：
- 按 Ctrl/Cmd + Shift + P 打开命令面板
- 输入命令名称或搜索
- 选择命令执行
通过快捷键：
- 可以为常用命令配置快捷键
- 在设置中搜索 "Keyboard Shortcuts"
- 搜索命令名称，添加快捷键绑定
通过聊天窗口：
- 在聊天窗口输入命令名称，AI 会识别并执行

常用命令示例

示例 1：生成单元测试

命令名称：生成单元测试
提示词：
请为以下代码生成完整的单元测试：
{{selected}}

要求：
1. 使用 Jest 测试框架
2. 覆盖所有分支和边界情况
3. 包含测试描述和断言
4. 使用有意义的测试用例名称

示例 2：代码审查

命令名称：代码审查
提示词：
请审查以下代码，提供：
1. 潜在的问题和 Bug
2. 性能优化建议
3. 代码风格改进建议
4. 安全性问题

代码：
{{selected}}

示例 3：生成 API 文档

命令名称：生成 API 文档
提示词：
请为以下 API 函数生成详细的文档注释，包括：
1. 函数描述
2. 参数说明
3. 返回值说明
4. 使用示例
5. 异常情况说明

代码：
{{selected}}

命令变量

可以在命令提示词中使用以下变量：

{{file}}：当前文件路径
{{selected}}：当前选中的代码
{{line}}：当前光标所在行号
{{workspace}}：工作区根目录路径
{{language}}：当前文件的语言类型

命令配置位置

全局命令：~/.cursor/commands.json
项目命令：.cursor/commands.json（项目根目录）

最佳实践

为常用任务创建命令模板，提高效率
使用描述性的命令名称，便于识别
在命令提示词中明确要求，确保输出质量
定期整理命令列表，删除不再使用的命令
与团队共享命令配置，保持一致性

4. 快捷键配置

Cursor 提供了丰富的快捷键，你可以自定义这些快捷键以适应个人习惯。

查看默认快捷键

打开快捷键设置：
- 打开 Cursor 设置（Ctrl/Cmd + ,）
- 搜索 "Keyboard Shortcuts"
- 或者使用快捷键 Ctrl/Cmd + K, Ctrl/Cmd + S
搜索快捷键：
- 在搜索框中输入功能名称（如 "chat"、"inline edit"）
- 查看对应的快捷键绑定
- 可以按快捷键查看绑定的功能

自定义快捷键

修改现有快捷键：
- 在快捷键列表中，找到要修改的命令
- 双击快捷键列，输入新的快捷键组合
- 如果快捷键已被占用，会显示冲突提示
添加快捷键：
- 找到没有快捷键的命令
- 点击 "+" 按钮，输入快捷键组合
删除快捷键：
- 右键点击快捷键，选择 "Remove Keybinding"
- 或者选中后按 Delete 键

Cursor 核心快捷键

快捷键	功能	说明
`Ctrl/Cmd + L`	打开 AI 聊天窗口	最常用的 AI 交互方式
`Ctrl/Cmd + K`	内联编辑	选中代码后使用，快速修改代码
`Tab`	接受 AI 补全	接受当前代码补全建议
`Esc`	拒绝 AI 补全	取消当前代码补全建议
`Ctrl/Cmd + Shift + L`	打开命令面板	执行自定义命令
`Ctrl/Cmd + /`	注释/取消注释	切换代码注释
`Ctrl/Cmd + Shift + R`	重构代码	选中代码后重构
`Ctrl/Cmd + Shift + F`	全项目搜索	搜索整个项目
`Alt + Z`	自动换行	切换编辑器自动换行
`Ctrl/Cmd + ,`	打开设置	访问 Cursor 设置

快捷键配置文件

快捷键配置保存在：

Windows/Linux：%APPDATA%\Cursor\User\keybindings.json
macOS：~/Library/Application Support/Cursor/User/keybindings.json

快捷键配置示例

[
  {
    "key": "ctrl+shift+a",
    "command": "cursor.chat.focus"
  },
  {
    "key": "ctrl+alt+k",
    "command": "cursor.inlineEdit"
  },
  {
    "key": "ctrl+shift+t",
    "command": "workbench.action.terminal.new"
  }
]

最佳实践

保持常用功能的快捷键简单易记
避免与系统快捷键冲突
为团队统一配置快捷键，提高协作效率
定期备份快捷键配置，便于迁移和恢复
使用快捷键组合时，考虑手指的舒适度

5. 其他重要配置

代码补全设置

补全触发设置：
- 配置自动补全的触发条件
- 设置补全延迟时间
- 配置补全建议数量
补全模型设置：
- 为代码补全选择专门的模型
- 平衡速度和准确性

隐私和安全设置

数据同步：
- 控制是否同步代码到云端
- 敏感项目建议关闭同步
Telemetry：
- 控制是否发送使用数据
- 根据隐私需求调整
代码索引：
- 控制哪些代码被索引
- 排除敏感文件

编辑器外观设置

主题配置：选择喜欢的编辑器主题
字体设置：配置代码字体和大小
布局设置：自定义编辑器布局

性能优化设置

索引优化：限制索引文件数量和大小
上下文窗口优化：合理设置上下文大小
缓存管理：定期清理缓存，提升性能

配置同步

账号同步：登录账号后，配置可以在多设备间同步
配置文件位置：
- 全局配置：~/.cursor/
- 项目配置：.cursor/ 或 .vscode/
导出配置：可以导出配置文件，便于备份和分享

六.总结

AI 编程心得精炼

趋势与态度：AI 编程是不可回避的发展方向，必须主动学习与掌握，才能在未来保有竞争力。
效率红利：合理运用工具可将开发效率提升至少三倍，但前提是理解工具边界并善于设计提示。
扎实基础：学习路径没有捷径，AI 只是加速器，无法替代持续的基础能力与知识积累。
幻觉风险：AI 容易产生看似合理却错误的输出，必须保持审慎，执行代码审查与验证。
使用节奏：以小步快跑（少量任务、频繁交互）的方式调用 AI，能降低幻觉累积，提升交付质量。

常用技能

1. Tab 编程（补全式协作）

2. 内联编辑（选中文本 → AI 重写）

3. Agent 编程（多步骤自动化）

4. Rules 的使用（团队协作的统一管理）

5. MCP 的使用（Ai自动化的功能扩展）

行动建议：建立“AI 合作者”心态——积极调用、谨慎验证、持续学习。
验证步骤：每次 AI 产出后执行静态检查、单元测试与逻辑推演，降低幻觉风险。
长远策略：将 AI 工具纳入日常工作流，但保留关键判断与质量把关在人类侧。

七. 资源与支持

官网文档：Cursor Documentation
社区支持：Cursor Discord
GitHub：Cursor Issues
学习资源：Cursor 文档

通过本手册，您可以快速掌握 Cursor 的 AI 编程能力，显著提升开发效率！🚀