快速上手

安装 Cursor 并登录，让 Cursor 解释代码库，做一个小改动，评审 diff 并验证结果，再用 Plan Mode 处理更大的改动。

这份指南带你从安装到在 Cursor 里做出第一个有用的改动：登录、让 Cursor 解释你的代码库、做一个小改动、评审结果。

安装 Cursor 并登录

从 cursor.com 下载 Cursor，打开应用并登录，然后选一个文件夹，从一个小任务开始。

macOS：macOS 12（Monterey）及更高版本，原生安装包（.dmg），支持 Apple Silicon 和 Intel
Windows：Windows 10 及更高版本，原生安装包（.exe）
Linux：推荐 Debian/Ubuntu 的 apt 仓库：添加 Cursor 的 GPG 密钥和仓库后 sudo apt install cursor；RHEL/Fedora 用 yum 仓库后 sudo dnf install cursor；也可以下载便携的 .AppImage（chmod +x 后运行）。官方说明 apt 和 yum 包优于 AppImage，因为它们提供桌面图标、自动更新和 CLI 工具

选好文件夹后，用 Cmd I 打开 Agent，让 Cursor 解释代码库并指出该先读的主要部分：

Explain this codebase. Point me to the main entry points, key modules, and anything I should read before making changes.

Cursor 会搜索你的仓库、读相关文件并总结项目如何组合在一起，这是熟悉陌生代码库最快的方法之一。

了解项目后，让 Cursor 建议几个安全的改进，挑一个让它去改：

Suggest three small, safe improvements in this codebase. Explain the tradeoffs and wait for me to choose one.

好的首个任务风险低，比如改善一些文案或修复小的界面问题。如果你已经知道想改什么，直接描述想要的结果即可。

Cursor 工作时你可以观察，diff 视图显示智能体做的改动。完成后评审 diff，并让 Cursor 运行项目已经在用的检查：测试、类型检查器、lint 或本地构建。

任务跨多个文件、需要调研、或需要在编码前获得批准时，用 Plan Mode。在 Agent 输入框里按 Shift+Tab 切换。Cursor 不会立即写代码，而是：研究你的代码库找出相关文件；就你的需求提出澄清问题；创建详细的实现计划；等你批准后再构建。