04 · 上手 / 使用教程

cursor使用教程 - 从索引到第一个 Agent 任务的完整流程

七天上手路线：等索引、下第一个任务、审查 diff、写 Rules、用 Tab 补全与内联编辑，附四组任务写法对照与五个新手常犯的错。

开始之前：等索引完成

新手最常踩的坑，是在索引还没跑完时就下达任务。

这份 cursor使用教程 面向第一次打开编辑器的中文开发者，按「装好 → 跑通第一个任务 → 会审查 → 会写规则」的顺序展开，最后给一条七天上手路线。

打开一个项目后，编辑器会先为代码建索引，让 Agent 能找到相关文件。索引没跑完时，它对项目结构的理解是残缺的，这时候让它改代码，常见结果是漏改文件、改错位置，或反复说找不到定义。

正确做法：打开项目后先等索引状态结束，再下第一个任务。大仓库第一次索引可能要几分钟，这段等待是值得的。

用一个小到能一眼看懂的改动练习完整闭环。

一条好用的任务公式

做什么 + 在哪做（@文件）+ 不能动什么 + 怎么算做完。四个要素齐了，Agent 跑偏的概率会明显下降。

同一件事，写法不同，结果差别很大。

场景	❌ 太模糊	✅ 更可执行
改 bug	「这里有问题，修一下」	「在 @src/cart.ts 的结算函数里，数量为 0 时应跳过折扣计算；不要改税率逻辑；补一个单测」
加功能	「加个搜索」	「在 @src/pages/List.tsx 增加按标题过滤的输入框；复用现有样式；不引入新的依赖」
重构	「把代码整理一下」	「只把 @src/utils/date.ts 里的格式化逻辑抽成纯函数，调用点保持不变，其他文件不动」
排查	「为什么跑不起来」	「解释 @server/app.ts 的启动顺序，指出可能抛错的位置，先不要修改任何文件」

共同点：给出范围、给出约束、给出验收标准。在 cursor使用教程 里，「不要改什么」往往比「要改什么」更能提高结果质量。

每次都重复说明风格很浪费，写成规则一次生效。

cursor / 项目规则示例

# 项目约定
- 使用 TypeScript，避免 any；新增函数需写明返回类型
- 提交信息用简体中文，格式为「类型: 简述」
- 不要自动修改 package.json 与锁文件
- 回答使用简体中文，代码与标识符保持英文
- 改动超过 3 个文件时，先列出计划再执行

用户级规则对所有项目生效，项目级规则随仓库共享。团队场景建议把「命名、注释语言、依赖变更、测试要求」写进项目级文件，避免每个人各写一套。详见团队协作。

不是每个动作都需要开 Agent。

Tab 补全

写到一半按 Tab 接受续写，适合样板代码、重复结构、简单条件分支。

内联编辑

选中一段代码直接描述改法，改动局限在选区，比开 Agent 更快也更可控。

语义检索

用自然语言问「登录态是在哪里校验的」，先定位再动手，避免盲改。

经验法则：小改用内联、找位置用检索、多文件才开 Agent。把 Agent 用在单行星号改动上，既慢又增加审查负担。

按后果排序，第一条最费时间。

把这五条避开，cursor使用教程 的上手曲线会平缓很多。

每天一个小目标，一周内形成稳定习惯。

走完这条路线，再去看 Agent 任务与文档速查，会顺畅得多。

三句话收尾。

cursor使用教程 的核心不是记住多少快捷键，而是养成「先索引、写清边界、逐段审查」的习惯。

任务描述里写清「做什么、在哪做、不能动什么、怎么算做完」，比反复换模型更能改善结果。

遇到装完仍是英文，回设置中文；遇到额度与模型疑问，看价格与常见问题。