Cursor 不完全使用指北
本指南旨在快速掌握 Cursor AI 编程助手的核心功能和使用技巧。
安装与配置
安装方式
Cursor 提供了便捷的安装方式，可以通过以下官方渠道获取：
基础配置
恢复 VSCode 布局
如果习惯了 VSCode 的布局，可以通过以下步骤恢复：
text
# cursor -> preferences -> vscode settings
search workbench.activityBar.orientation
选择 vertical核心概念与快捷键
重要概念辨析
以下是两个容易混淆但概念截然不同的术语：
- submit：代码提交操作
- codebase：代码库，指整个项目的代码集合
Cmd + K 快捷键
Cmd + K 是 Cursor 中最常用的快捷键之一，它具有以下功能：
- 上下文感知建议：根据当前光标位置，智能提供代码片段、函数或变量的建议
- 全场景支持：在编辑器和命令行中均可使用
功能特性
@Web 功能
@Web 是 Cursor 提供的强大功能之一：
- 功能定义：用于引用外部网络资源和文档
- 使用场景：获取参考资料、查询 API 文档、浏览相关示例
实际应用示例
以下是一些常见的使用场景：
- 查看函数定义：在代码中遇到陌生函数时，按 Cmd + K 快速查看其定义
- 查找文档示例：使用 @Web 搜索相关库的使用示例
@ 召唤工具
Cursor 提供了丰富的工具集，可以通过 @ 符号快速调用：
核心工具
以下是最常用的核心工具：
- @Files - 引用项目中的特定文件
- @Folders - 引用整个文件夹以获取更广泛的上下文
- @Code - 引用代码库中的特定代码片段或符号
- @Docs - 访问文档和指南
版本控制工具
- @Git - 访问 git 历史记录和更改
- @Recent Changes - 查看最近的代码修改
AI 辅助工具
- @Cursor Rules - 使用光标规则
- @Summarized Composers - 使用总结的作曲家会话
- @Codebase - 作为上下文引用整个代码库（仅限聊天）
- @Lint Errors - 引用 lint 错误（仅限聊天）
其他工具
- @Web - 引用外部网络资源和文档
- @Link - 创建指向特定代码或文档的链接
- @Definitions - 查找符号定义（仅限 Cmd K）
- @Notepads - 访问笔记本
此外，还有一些特殊符号可以使用：
- #Files - 添加文件到上下文而不引用
- /Commands - 将打开和活动文件添加到上下文
三种工作模式详解
Cursor 提供了三种不同的工作模式，每种模式都有其特定的使用场景和权限范围：
Ask 模式
最基础的交互模式，适合快速获取信息和解答问题。
主要特点：
- 简单直接的问答交互
- 快速响应
- 无代码修改权限
- 适合获取知识和建议
Agent 模式
强大的任务执行模式，适合处理复杂的开发任务。
核心能力：
- 执行多步骤任务
- 分析整个代码库
- 提供深度上下文建议
- 可执行授权命令
- 处理时间较长
Edit 模式
直接的代码编辑模式，最适合实际的编码工作。
关键特性：
- 直接修改代码
- 实时代码建议
- 支持代码重构
- 深度集成编辑器功能
Rules 系统
Cursor 的 Rules 系统是一个强大的定制化工具，可以帮助你更好地管理和使用 AI 助手。
全局 Rules
在 Cursor settings 中配置的全局规则，将应用于所有项目：
- 统一的编码风格
- 通用的开发规范
- 跨项目的 AI 行为定制
项目 Rules
项目级别的规则需要启用 `Include .cursorrules file` 选项。
版本 0.45 之前
在项目根目录创建 `.cursorrules` 文件来配置规则：
版本 0.45 及之后
支持将规则分类存储在不同文件中，通过 `@Cursor Rules` 引用：
使用 `npx codefetch` 可以获取项目结构，方便配置 Cursor Rules。