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



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

安装步骤

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

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

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

使用步骤

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

适用场景

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

**实践

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

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

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

使用步骤

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

适用场景

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

**实践

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

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

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

使用步骤

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

适用场景

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

**实践

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

4. Rules 的使用

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

使用步骤

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

Rules 配置示例

适用场景

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

**实践

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

5. MCP 的使用

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

使用步骤

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

MCP 使用示例

示例 1：使用文件系统 MCP

示例 2：使用数据库 MCP

示例 3：使用 Figma MCP

配置 MCP 服务器

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

• （全局配置）
• 项目根目录的 （项目配置）

配置示例：

适用场景

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

**实践

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

快捷键参考

高效需求描述

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

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

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

高效需求描述要点

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

其他**实践

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

1. 模型选择

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

配置步骤

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

模型选择建议

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

模型配置位置

• 设置路径：
• 配置文件：（全局）或项目根目录 （项目级）

2. 文档配置

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

配置步骤

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

使用 @ 符号引用文档

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

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

文档配置示例

**实践

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

3. Commands 配置

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

创建自定义命令

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

使用自定义命令

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

常用命令示例

示例 1：生成单元测试

示例 2：代码审查

示例 3：生成 API 文档

命令变量

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

• ：当前文件路径
• ：当前选中的代码
• ：当前光标所在行号
• ：工作区根目录路径
• ：当前文件的语言类型

命令配置位置

• 全局命令：
• 项目命令：（项目根目录）

**实践

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

4. 快捷键配置

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

查看默认快捷键

1. 打开快捷键设置：
   • 打开 Cursor 设置（）
   • 搜索 "Keyboard Shortcuts"
   • 或者使用快捷键
2. 搜索快捷键：
   • 在搜索框中输入功能名称（如 "chat"、"inline edit"）
   • 查看对应的快捷键绑定
   • 可以按快捷键查看绑定的功能

自定义快捷键

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

Cursor 核心快捷键

快捷键配置文件

快捷键配置保存在：

• Windows/Linux：
• macOS：

快捷键配置示例

**实践

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

5. 其他重要配置

代码补全设置

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

隐私和安全设置

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

编辑器外观设置

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

性能优化设置

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

配置同步

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

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 编程能力，显著提升开发效率！🚀