文档 / 入门 / 使用

Cursor 使用指南

本指南将介绍 Cursor 的基本用法和主要功能，帮助您快速上手这款强大的 AI 代码编辑器。

界面概览

Cursor 的界面布局类似于 VS Code，包括以下主要部分：

  • 活动栏：位于最左侧，包含文件浏览器、搜索、源代码控制、调试和扩展等图标。
  • 侧边栏：显示活动栏中选择的功能，如文件浏览器、搜索结果等。
  • 编辑区：中央区域，用于显示和编辑文件内容。
  • AI 聊天面板：可通过快捷键打开，用于与 AI 交互。
  • 状态栏：位于底部，显示当前文件信息、行号、编码格式等状态信息。

打开项目

在 Cursor 中打开项目有多种方式：

  1. 通过菜单
    • 点击菜单 "文件 > 打开文件夹"
    • 选择要打开的项目文件夹
  2. 通过命令面板
    • 按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）打开命令面板
    • 输入 "文件: 打开文件夹" 并选择
  3. 从欢迎页面
    • 点击 "打开文件夹" 或 "打开最近项目"

核心功能

1. AI 代码补全 (Tab)

Cursor 提供强大的 AI 代码补全功能，可以智能预测您接下来想要编写的代码：

  • 在编码时，将自动显示灰色的建议文本
  • 按 Tab 键接受建议
  • 按 Esc 键拒绝建议
  • 支持多行代码补全和完整函数生成

详细了解：Tab 补全概述

2. Composer

Composer 允许您使用自然语言生成或修改大段代码：

  • 选择要修改的代码区域（可选）
  • 按下 Ctrl+K（Windows/Linux）或 Cmd+K（Mac）打开 Composer
  • 输入您需要的功能或更改的自然语言描述
  • Cursor 将根据您的描述生成或修改代码

详细了解：Composer 概述

3. AI 聊天

与 AI 助手交流，获取编码帮助和解释：

  • 按下 Ctrl+Shift+L（Windows/Linux）或 Cmd+Shift+L（Mac）打开聊天面板
  • 输入问题或请求以获取帮助
  • 可以询问代码解释、编程概念、调试帮助等
  • 支持与当前代码上下文相关的问答

详细了解：AI 聊天概述

4. 上下文管理

帮助 AI 理解您的代码库和项目，提供更准确的建议：

  • 使用特殊命令如 @code, @file, @codebase 等在聊天中引用代码
  • Cursor 会自动索引您的代码库，提高理解能力
  • 支持设置 AI 规则，指导 AI 如何理解和处理您的代码

详细了解：上下文管理基础

常用键盘快捷键

功能 Windows / Linux macOS
接受 AI 补全建议 Tab Tab
打开 Composer Ctrl+K Cmd+K
打开 AI 聊天 Ctrl+Shift+L Cmd+Shift+L
执行生成代码 Ctrl+Enter Cmd+Enter
快速打开文件 Ctrl+P Cmd+P
打开命令面板 Ctrl+Shift+P Cmd+Shift+P
保存文件 Ctrl+S Cmd+S
撤销操作 Ctrl+Z Cmd+Z
重做操作 Ctrl+Y Cmd+Shift+Z

完整快捷键列表请参考：键盘快捷键

编码工作流程

以下是使用 Cursor 的推荐工作流程：

  1. 创建或打开项目

    首先打开您想要处理的项目文件夹。建议使用完整项目而不是单个文件，这样 Cursor 可以更好地理解上下文。

  2. 导航到相关文件

    使用文件浏览器或快速打开（Ctrl+P / Cmd+P）找到您要编辑的文件。

  3. 利用 AI 编码
    • 边写代码边使用 Tab 补全，提高编码速度
    • 使用 Composer 生成更复杂的代码块或进行大范围修改
    • 遇到问题时，使用 AI 聊天 寻求帮助和解释
  4. 代码审查与优化

    可以请求 AI 审查您的代码，提供改进建议，或解释复杂部分。

  5. 调试与修复

    使用内置的调试工具或向 AI 描述错误以获取可能的解决方案。

高效使用技巧

  1. 使用注释引导 AI

    在代码中添加注释来描述您想要实现的功能，可以帮助 AI 生成更准确的代码。

    // 创建一个函数，计算两个数的平均值
// 参数应该是两个数字，返回它们的平均值
// 如果输入不是数字，应该抛出错误
  2. 提供详细上下文

    在使用 Composer 或聊天功能时，提供详细的上下文信息，包括项目背景、技术要求和限制条件。

  3. 迭代式工作

    先生成代码框架，然后逐步细化或修改，而不是尝试一次生成完美代码。

  4. 结合传统编码技巧

    AI 是助手而非替代品，结合您的编程知识和 AI 建议，可以达到最佳效果。

  5. 学习并调整 AI 规则

    创建适合您项目的 Cursor AI 规则，帮助 AI 更好地理解您的代码风格和项目要求。

常见问题

  • 问题：AI 补全不符合项目需求

    解决方案：提供更多上下文，使用注释指导 AI，或设置项目特定的 AI 规则。

  • 问题：编辑器变慢或卡顿

    解决方案：检查是否打开了过大的文件，关闭不必要的扩展，或增加内存分配。

  • 问题：AI 聊天没有理解代码上下文

    解决方案：确保项目已被正确索引，使用 @code 或 @file 命令明确引用相关代码。

接下来的步骤

掌握基础后，建议您：