本指南将带您从安装开始，到在 Cursor 中完成第一次有用的改动。您将登录，让 Cursor 讲解你的代码库，做一个小改动，并审查结果。
安装 Cursor 并登录¶
下载 Cursor，打开应用并登录。然后选择一个文件夹，从一项小任务开始。
macOS¶
- macOS 12 (Monterey) 及更高版本
- 原生安装程序 (.dmg)
- 支持 Apple Silicon 和 Intel
Windows¶
- Windows 10 及更高版本
- 原生安装程序 (.exe)
Linux¶
Debian/Ubuntu (推荐)
# 添加 Cursor 的 GPG 密钥
curl -fsSL https://downloads.cursor.com/keys/anysphere.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/cursor.gpg > /dev/null
# 添加 Cursor 软件仓库
echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/cursor.gpg] https://downloads.cursor.com/aptrepo stable main" | sudo tee /etc/apt/sources.list.d/cursor.list > /dev/null
# 更新并安装
sudo apt update
sudo apt install cursor
RHEL/Fedora
# 添加 Cursor 软件仓库
sudo tee /etc/yum.repos.d/cursor.repo << 'EOF'
[cursor]
name=Cursor
baseurl=https://downloads.cursor.com/yumrepo
enabled=1
gpgcheck=1
gpgkey=https://downloads.cursor.com/keys/anysphere.asc
EOF
# 安装 Cursor
sudo dnf install cursor
AppImage (便携版)
从 cursor.com/downloads 下载 .AppImage 文件，然后：
chmod +x Cursor-*.AppImage
./Cursor-*.AppImage
相比 AppImage，建议优先使用 apt 和 yum 软件包。它们提供桌面图标、自动更新和命令行工具。
让 Cursor 讲解你的代码库¶
选择文件夹后，按 Cmd I 打开智能体。让 Cursor 讲解你的代码库，并指出应优先阅读的主要部分。
讲解这个代码库。指出主要入口点、关键模块，以及在进行更改前我应该阅读的内容。
Cursor 会搜索您的仓库、读取相关文件，并梳理项目的整体结构。这是在陌生代码库中快速熟悉情况的方式之一。
想深入了解？请参阅了解您的代码库。
进行一项小更改¶
了解项目后，让 Cursor 推荐几项安全的小改进。选择其中一项，并让它完成更改。
为这个代码库建议三项小而安全的改进。说明其中的取舍，并等待我选择其中一项。
适合作为首个任务的是低风险工作，例如优化文案或修复小型 UI 问题。
如果您已经知道想更改什么，直接提出要求并描述期望结果。
评审 diff 并验证结果¶
现在您可以观察 Cursor 如何工作。diff 视图会显示智能体所做的更改。
完成后，评审 diff，并让 Cursor 运行项目现有的检查，例如测试、类型检查、lint 或本地构建。
想使用更完善的评审流程？请参阅评审和测试代码。
对较大更改使用 Plan 模式¶
现在您已经掌握了基础知识，可以对较大更改使用 Plan 模式。当任务涉及多个文件、需要调研，或需要在编写代码前获得批准时，它尤其适合。
在智能体输入框中按 Shift+Tab 切换 Plan 模式。Cursor 不会立即编写代码，而是会：
- 调研您的代码库以查找相关文件
- 就您的需求提出澄清性问题
- 创建详细的实现计划
- 在开始实现前等待您的批准
如需深入了解，请参阅构建新功能。
后续步骤¶
智能体概览¶
了解智能体的工具和能力
规则¶
为您的项目创建持续生效的指令
了解您的代码¶
学习如何快速熟悉陌生的仓库
构建新功能¶
了解上线较大更改的完整工作流程
