01-Cursor 快速上手

本指南帮助你在 30 分钟内掌握 Cursor 的基本使用。

---

一、安装与配置

1.1 下载安装

1. 访问 cursor.com
2. 下载对应系统版本（Windows/macOS/Linux）
3. 安装并启动

1.2 初始设置

首次启动时会引导完成：

• 登录: 使用 GitHub 或 Google 账号登录
• 导入配置: 可从 VSCode 导入设置和插件
• 选择主题: 深色/浅色主题

1.3 Python 开发环境配置

// settings.json 推荐配置
{
  "python.defaultInterpreterPath": "python3",
  "python.linting.enabled": true,
  "python.linting.pylspEnabled": true,
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "ms-python.black-formatter"
}

---

二、界面介绍

2.1 主界面布局

┌─────────────────────────────────────────────────┐
│  活动栏 │  文件资源管理器  │        编辑器区域        │
│  (左侧) │    (左侧)       │       (中央)            │
│         │                 │                         │
│   📁    │   project/      │   ┌─────────────────┐   │
│   🔍    │   ├── src/      │   │ 代码编辑区       │   │
│   🤖    │   ├── tests/    │   │                 │   │
│   ⚙️    │   └── README.md │   └─────────────────┘   │
│         │                 │                         │
│         │                 │   ┌─────────────────┐   │
│         │                 │   │   AI Chat 面板   │   │
│         │                 │   │   (Ctrl+L)      │   │
│         │                 │   └─────────────────┘   │
└─────────────────────────────────────────────────┘

2.2 核心面板说明

面板	快捷键	功能
AI Chat	Ctrl+L / Cmd+L	侧边栏对话
Agent	Ctrl+I / Cmd+I	智能代理模式（自动多文件编辑）
Inline Edit	Ctrl+K / Cmd+K	行内编辑
终端	Ctrl+`	集成终端

---

三、基础操作

3.1 打开项目

# 方式1：通过界面
File → Open Folder → 选择项目目录

# 方式2：命令行
cursor /path/to/your/project

3.2 创建文件

操作	快捷键	说明
新建文件	Ctrl+N	创建空文件
新建文件夹	右键 → New Folder	创建目录
快速创建	Ctrl+P → 输入文件名	直接创建并打开

3.3 与 AI 对话

方式1：侧边栏 Chat

1. 按 Ctrl+L 打开 Chat 面板
2. 输入问题，例如：
   "帮我解释这段代码的作用"
   "如何优化这个函数"
3. 按 Enter 发送

方式2：选中代码询问

1. 选中要询问的代码
2. 右键 → "Add to Chat" (Ctrl+Shift+L)
3. 输入问题并发送

3.4 Agent 模式（智能代理）

Agent 是 Cursor 的智能代理模式，可以自动分析项目结构并执行多文件操作。

四种对话模式（按 Ctrl+I 打开面板后，在顶部切换）：

模式	图标	功能	适用场景
Agent	🤖	智能代理，自动分析并修改多文件	跨文件重构、功能开发、复杂任务
Plan	📋	规划模式，分步骤规划和执行	大型功能开发、项目规划
Debug	🐛	调试模式，诊断和修复问题	Bug 修复、错误诊断、性能优化
Ask	💬	询问模式，仅咨询不修改代码	代码解释、技术咨询、学习理解

使用 Agent 模式：

1. 按 Ctrl+I 打开 Agent 面板
2. 在顶部选择 "Agent" 模式（默认）
3. 输入需求，例如：
   "为 User 模型添加 email 验证功能"
   "重构所有 API 路由的错误处理"
4. Agent 会自动：
   - 分析需要修改的文件
   - 生成修改方案
   - 展示计划（可确认或调整）
   - 执行修改

Agent vs Chat 的区别：

• Chat：一问一答，你可以手动应用代码建议
• Agent：智能代理，自动决定修改哪些文件并直接执行

---

四、常用快捷键

4.1 编辑快捷键

功能	Windows/Linux	macOS
打开 Chat	Ctrl+L	Cmd+L
打开 Agent	Ctrl+I	Cmd+I
Inline Edit	Ctrl+K	Cmd+K
接受 AI 建议	Tab	Tab
拒绝 AI 建议	Esc	Esc

4.2 代码导航

功能	快捷键
跳转到定义	F12
返回上一位置	Alt+←
查找引用	Shift+F12
全局搜索	Ctrl+Shift+F

---

五、快速示例

示例1：生成 Python 函数

1. 在编辑器中输入：
   "写一个计算斐波那契数列的函数"

2. 按 Ctrl+K 打开 Inline Edit

3. Cursor 会自动生成代码：

def fibonacci(n: int) -> int:
    """计算斐波那契数列的第 n 项"""
    if n <= 1:
        return n
    return fibonacci(n - 1) + fibonacci(n - 2)

示例2：解释代码

1. 选中一段代码
2. 按 Ctrl+L 打开 Chat
3. 输入："解释这段代码"
4. AI 会详细解释代码逻辑

示例3：修复错误

1. 当代码有错误时（红色波浪线）
2. 将鼠标悬停在错误处
3. 点击 "Fix with AI"
4. Cursor 自动提供修复建议

---

六、常见问题

Q1: Cursor 和 VSCode 有什么区别？

A: Cursor 是基于 VSCode 的 AI 增强版本，核心区别：

• 内置 AI Chat、Composer、Tab 补全
• 无需额外安装 AI 插件
• 针对代码理解做了专门优化

Q2: 如何导入 VSCode 配置？

A（适用于 Cursor 2.6.22+）：

方式1 - 搜索（推荐）：

1. 按 Ctrl+, 打开 Settings
2. 搜索框输入 "import from vscode"
3. 找到 "VS Code: Import" 设置项

方式2 - 菜单：

Settings → General → VS Code: Import → 选择要导入的内容
或
Settings → Cursor Settings → General → VS Code: Import

首次启动：安装 Cursor 后首次打开时会自动提示导入

Q3: AI 响应慢怎么办？

A:

1. 检查网络连接
2. 使用 Cursor Tab 本地补全（更快）
3. 避免一次性发送过长代码

Q4: 如何关闭 AI 功能？

A（适用于 Cursor 2.6.22+）：

推荐 - 搜索方式：

1. Ctrl+, 打开 Settings
2. 搜索 "AI" 或 "cursor" 或具体功能如 "tab"
3. 找到相关开关：
   - "Cursor: Enable AI"（总开关）
   - "Cursor: Enable Tab"（Tab 补全）
   - "Cursor: Enable Chat"（Chat 功能）

菜单方式：

Settings → Cursor Settings → 调整各项 AI 功能的开关
或
Settings → Features → AI相关设置

---

七、下一步学习

完成本指南后，建议继续学习：

1. 02-AI对话核心技巧.md - 掌握高效对话技巧
2. 07-Cursor独有技巧.md - 学习 Tab 补全、@引用等高级功能

---