Cursor使用指南 · 第1讲 · 安装与第一次打开

本节在系列里讲什么

Cursor 使用指南 共 10 讲，对照 Cursor 官方文档（https://docs.cursor.com）。本讲只做安装与环境：下载客户端、账号登录、打开真实仓库、Agent 里问一句关于本仓库结构的问题。Rules、MCP、CLI 从后面讲拆。

官方文档链接（建议收藏）

• 文档根：https://docs.cursor.com
• 本讲 · 下载与入门：https://cursor.com （Install 后 Welcome 流程）
• CLI 安装（第 7 讲预习）：https://docs.cursor.com/en/cli/installation
• Agent 总览（下讲）：https://docs.cursor.com/agent/overview

安装与账号

工程路径：

1. https://cursor.com → Download（Windows / macOS / Linux）
2. 安装后首次打开 → Sign in（GitHub / Google / 邮箱，以你界面为准）
3. File → Open Folder 选 真实 git 仓库根目录（别只 Open File 单文件）

个人见解：公司机若 禁止未签名安装包，先走 IT 白名单；WSL 里开发 仍建议 Windows 版 Cursor + Remote/WSL 扩展（细节第 8 讲索引时再抠），今天先保证 Windows 本机能 Open Folder。

等 Indexing（右下角或状态栏）跑完再开 Agent——我踩过的坑：索引未完成就问「改哪个文件」，Agent 只能猜路径。

第一次 Agent 对话（只读）

打开 Agent 面板（侧边栏或快捷键，以版本为准），在 已打开文件夹 下问：

```text
只读：用三句话说明这个仓库的目录结构，并指出 README 在哪。不要改任何文件。
```

验收三点：是否提到真实目录名、是否找到 README、是否没有擅自写盘。若它要执行终端命令，先看 diff/命令再 Accept——第 1 讲习惯从 只读 开始。

密钥：模型调用走 Cursor 账号订阅，不要把 API Key 写进仓库 .env 再截图发群。

跟做清单

• [ ] 从 cursor.com 安装并 Sign in
• [ ] Open Folder 打开本地仓库根目录
• [ ] 等待 Indexing 完成（小仓库通常几分钟内）
• [ ] Agent 完成 1 次只读 结构问答
• [ ] 收藏 docs.cursor.com 与 agent/overview 链接

下讲预告

下一讲 Agent 模式总览——Composer/Agent 分工、何时用 Tab 行内改。