第一个项目 30 分钟：Cursor 使用教程别从 Agent 扫全库开始

装完 Cursor，模型下拉里名字一堆，侧栏又能聊又能改文件——最容易踩的坑是：把整个仓库扔给 Agent，说一句「帮我重构一下」。十分钟后 diff 几百行，你既审不动，额度也烧一截。搜「cursor使用教程」的人要的其实更土：第一个小项目怎么在半小时内跑通。

「Cursor 是什么」见 入门说明；装好后一天怎么穿 Tab/Chat/Agent 见 日常教程。这篇只排一条时序。

准备：一个你能删的小仓库

别用公司巨型 monorepo 当第一次练习。随便一个几十到几百个文件的个人小项目，或 git clone 一个示例仓到本地。安装包仍从官网取，见 下载安装。

在 Cursor 里用 File → Open Folder（macOS 常见是打开文件夹）选中该目录。等右下角/状态区索引消停一点再开聊——大仓第一次索引会吵，这正常。

前 10 分钟：只练 Tab

打开一个你熟悉的源文件，在函数中间另起一行，开始打字。灰色幽灵文本出来后，用 Tab 接受（具体键位以客户端提示为准）。目标不是「写完功能」，而是确认：补全能出、你敢按、按完你看得懂。

若灰色建议一直不出现，先确认光标在可编辑代码区、当前文件类型受支持，再查网络/登录是否正常。别急着怪模型。

中间 10 分钟：Ask 只问报错

故意跑一下项目里已有的测试或启动命令，把终端里的报错原文（英文那几行）贴进侧栏 Ask / Chat。问题写成：「这段报错在说什么？指出该改哪个文件的哪一段，先别直接改仓库。」

逼自己读完它指出的位置，再决定要不要让它改。Chat、Composer、Agent 入口差别见 三种用法。

最后 10 分钟：Agent 只改一个文件

切到 Agent（模式说明见 Agent 入门），指令写死边界，例如：「只修改 src/foo.ts，为函数 bar 补上空值判断；不要动其它文件；改完用一句话说明怎么验证。」

出来后先看 diff：有没有碰你没点名的路径。有就越权，回滚或拒绝，把禁区写进下一次提示。没有再本地跑你刚才那条验证命令。

怎样算这 30 分钟没白费

• 仓库是用 Open Folder 打开的，不是只拖了一个单文件进去却以为「工程已加载」；
• 你亲手 Tab 接受过至少一行补全；
• Ask 里贴过真实报错原文，并自己点开过它指的文件；
• Agent 的 diff 落在你指定的单个文件上。

过了这四关，再去看日常教程里的「一天怎么穿」。顺序反了，教程读再多也像在看功能说明书。