快速开始
按 Cursor 官方 Quickstart，从安装登录到第一次解释代码库、小改动、diff review 和 Plan Mode。
Cursor 官方 Quickstart 的目标很明确：从 install 到 first useful change。你要完成登录、让 Cursor 解释代码库、做一个小改动、审查结果，然后知道什么时候切到 Plan Mode。
第一天不要追求“让 Agent 大改项目”。先跑通一个低风险闭环。
阅读目标：读完本章，你应该能在低风险项目里完成一次可控的 Cursor 任务：解释代码库、选一个小改动、审 diff、跑检查。
1. 安装并登录
官方 Quickstart 和 Help Center 都要求先安装 Cursor 并登录。不同系统要求：
| 平台 | 官方要求或路径 |
|---|---|
| macOS | macOS 12 Monterey 及以上；.dmg 原生安装器；支持 Apple Silicon 和 Intel |
| Windows | Windows 10 及以上；.exe 原生安装器 |
| Debian / Ubuntu | 推荐 apt repo 安装 |
| RHEL / Fedora | 推荐 yum / dnf repo 安装 |
| AppImage | 可 portable 使用，但 apt / yum 更推荐 |
官方说明 apt / yum 包比 AppImage 更优先，因为它们提供 desktop icons、automatic updates 和 CLI tools。
如果偏好命令行，Cursor 也提供一键安装脚本（同时安装 GUI + CLI agent 命令）：
# macOS / Linux / WSL
curl https://cursor.com/install -fsS | bash
# Windows PowerShell
irm 'https://cursor.com/install?win32=true' | iex下载入口用官方站，不要从网盘、第三方镜像或所谓整合包开始。Cursor 会接触代码、命令和账号工作流，安装源必须干净。
2. 先打开低风险项目
官方 Quickstart 建议 pick a folder and start with a small task。第一天建议：
- 选择 demo repo、文档仓库或非生产项目。
- 不要直接打开包含生产密钥的仓库。
- 不要让 Cursor 一上来跑部署、删除、迁移或账单相关命令。
flowchart TD
Install["安装并登录"] --> Folder["打开低风险 folder"]
Folder --> Explain["让 Cursor 解释代码库"]
Explain --> Small["选择一个小改动"]
Small --> Diff["Review diff"]
Diff --> Checks["运行 tests / typecheck / lint / build"]
Checks --> Plan["较大任务再用 Plan Mode"]3. 让 Cursor 解释代码库
官方 Quickstart 推荐打开 Agent，然后让 Cursor 解释代码库并指出先读哪里。示例可以写成：
Explain this codebase. Point me to the main entry points, key modules, and anything I should read before making changes.中文项目可以这样写：
请只读解释这个代码库。
请指出主要入口、关键模块、配置文件、测试入口，以及修改前必须先读的文件。
不要创建、修改或删除任何文件。这一步不是为了拿到漂亮总结，而是验证 Cursor 能正确读取当前 workspace，并能把项目结构讲清楚。
4. 做一个小改动
官方建议先让 Cursor suggest a few safe improvements，然后你选一个，再让它改。
Suggest three small, safe improvements in this codebase.
Explain the tradeoffs and wait for me to choose one.适合第一天的小任务：
| 任务 | 原因 |
|---|---|
| 改一段文案 | 风险低，diff 容易读 |
| 修一个小 UI 问题 | 可以截图验证 |
| 补一个简单测试 | 可用测试命令验收 |
| 改 README 小节 | 不影响运行时 |
不适合第一天：
- 重构目录结构。
- 升级多个依赖。
- 修改认证、支付、部署配置。
- 运行生产环境命令。
5. Review diff 并验证
官方 Quickstart 明确要求 review the diff，并让 Cursor 运行项目已有检查：tests、type checker、linting 或 local build。
验收顺序：
- 看 diff 是否只改目标文件。
- 问 Cursor 为什么这样改。
- 跑项目已有检查。
- UI 任务补截图或本地预览。
- 决定保留、继续迭代或撤回。
不要只看 Cursor 的自然语言总结。真实验收看 diff、测试输出、浏览器结果和 Git 状态。
6. 大任务切 Plan Mode
官方 Quickstart 说明，较大任务用 Plan Mode。切换方式是：在 agent input 里按 Shift+Tab；输入"重构 / 迁移 / 跨模块"等复杂关键词时 Cursor 也会自动建议切到 Plan。
Plan Mode 会：
- Research your codebase to find relevant files。
- Ask clarifying questions about your requirements。
- Create a detailed implementation plan。
- Wait for your approval before building。
深读：为什么 Quickstart 先做小改动，而不是先跑大任务
Cursor 的核心价值是让 Agent 参与真实开发，但第一天你还没有验证 workspace、规则、权限、模型、命令和 review 习惯。小改动能让你用最小风险跑通完整链路：读代码、提出建议、修改、审 diff、跑检查。
一旦这个闭环稳定，再把任务扩大到 Plan Mode。这样遇到问题时，你知道是任务复杂度带来的问题，而不是安装、上下文或基础使用方式没跑通。
本章自检
完成本章后，用这 3 个问题检查自己是否真正理解：
- 官方 Quickstart 里的 first useful change 应该包含哪些步骤？
- 为什么第一条解释代码库 prompt 要强调只读？
- 什么情况下应该从普通 Agent 切到 Plan Mode？
通过标准：你能在一个低风险项目里完成“解释代码库 -> 小改动 -> diff review -> 检查命令”的闭环。
官方来源
- Cursor Quickstart —— 官方说明安装登录、解释代码库、小改动、review diff、运行检查和 Plan Mode。
- Cursor Install Help —— 官方 Help Center 安装流程。