AI教程
Cursor 教程 2026:Composer 2、智能体窗口与 30 分钟实战流程
这篇 Cursor 教程按 2026 年 Cursor 3.0 与 Composer 2 更新,带你完成安装、代码库索引、Rules 配置、Agent 改代码、价格判断与避坑清单。
如果你搜索「Cursor 教程」,你真正想解决的通常不是“按钮在哪里”,而是:Cursor 能不能读懂我的项目、改多文件、跑测试,并且让我知道它改了什么?这篇按 2026 年 4 月 30 日可公开验证的信息,给你一套适合真实项目的 Cursor 工作流。
先说结论:Cursor 适合已经有一个可运行项目、愿意 review diff、能写清验收标准的人;不适合把商业项目完全丢给 AI “从 0 自动完成”。更稳的用法是把任务缩小到 30 分钟到 2 小时能验收:修一个 bug、补一个接口、重构一个组件、给页面补测试。
图片来源:POPMARS 自制工作流示意图,用于替代官方产品图作为封面与社交分享图,降低品牌素材复用风险。
先看结论:Cursor 适合谁、不适合谁?
| 你是哪类用户 | 是否适合 Cursor | 建议用法 |
|---|---|---|
| 已经会跑项目的开发者 | 适合 | 用 Ask 读代码,再让 Agent 改小范围任务并跑测试。 |
| 独立开发者 / 技术创始人 | 适合 | 把需求拆成可验收的小 PR,要求 Cursor 先列计划。 |
| 产品、运营、设计同学 | 谨慎适合 | 适合改文案、样式和内部工具原型,但必须有人 review diff。 |
| 想从 0 自动生成完整商业项目的人 | 不适合 | 先学习项目结构、测试和部署,不要把判断权交给 AI。 |
Cursor 2026 有什么新变化?
Cursor 3.0 把界面重心进一步转向智能体。官方 changelog 显示,新的 Agents Window 可以让多个智能体在本地、worktree、云端和远程 SSH 环境中并行运行,并可通过命令面板打开。对开发者来说,这意味着 Cursor 不只是一个“会聊天的 VS Code”,而更像一个能分支实验、执行命令、比较结果的 AI 工作台。
Composer 2 是 Cursor 2026 年 3 月发布的编程模型。Cursor 官方博客称标准 Composer 2 在 Cursor 中可用,价格为每百万输入 tokens 0.50 美元、每百万输出 tokens 2.50 美元;fast 变体为每百万输入 tokens 1.50 美元、每百万输出 tokens 7.50 美元。官方也给出 CursorBench、Terminal-Bench 2.0、SWE-bench Multilingual 等 benchmark 结果。发布时要注意:这些是 Cursor 报告的指标,适合判断趋势,但最终仍要用你自己的项目、测试和 review 来验证。
图片来源:POPMARS 自制流程图,展示从 Ask 到人工 review 的最小闭环。
第一步:安装、登录、索引代码库
- 从 Cursor 官方下载页安装客户端并登录。
- 打开一个你能本地运行的项目,最好有 README、测试命令和清晰目录结构。
- 等待代码库索引完成。Cursor Codebase Indexing 文档说明,Cursor 会为代码库文件计算 embeddings;新文件会增量索引,状态可在
Cursor Settings > Indexing & Docs查看。 - 把构建产物、日志、大数据文件放进
.gitignore、.cursorignore或.cursorindexingignore,避免污染检索结果。
索引质量会直接影响回答质量。索引没完成时就问“登录流程在哪里”,Cursor 可能只能看当前打开文件;索引完成后,它更有机会找到入口文件、相关 service 和测试。
第二步:写一个 Cursor 能执行的任务
把 Cursor 当成会执行命令的初级同事,而不是许愿机。建议使用这个结构:
目标:给订单列表增加按状态筛选。
范围:只改 apps/web/src/orders;不要改数据库 schema。
验收:npm test -- orders 通过,页面保留现有样式。
上下文:状态枚举在 packages/shared/order.ts。
流程:先读代码并列计划,等我确认后再改。
陌生项目先用 Ask 读代码,确认路径后再切 Agent;高风险业务代码要求它先给计划。Cursor Chat / Agent 文档对 Agent 的定位是:能完成复杂编程任务、运行终端命令并编辑代码。也正因为它能动手,你更要明确范围、测试命令和禁止事项。
第三步:用 Agent 跑一个 30 分钟闭环
推荐新手第一次实战这样做:
| 步骤 | 你做什么 | Cursor 做什么 | 验收点 |
|---|---|---|---|
| 1 | 打开项目并确认索引完成 | 读取项目上下文 | 能说出入口、测试命令 |
| 2 | 用 Ask 询问相关模块 | 找文件与调用链 | 你确认范围没偏 |
| 3 | 输入小任务提示词 | 给计划,不先改 | 计划能对应验收标准 |
| 4 | 切 Agent 执行 | 改文件、跑命令、修错误 | 最小测试通过 |
| 5 | 你 review diff | 解释改动与风险 | 没有越界改动 |
如果结果不满意,不要继续在同一轮里堆提示词。更好的方式是缩小范围、补充验收、或用 worktree / best-of-n 做第二版,再比较差异。
第四步:用 Rules 固化团队偏好
Cursor Rules 文档说明,Project Rules 存在 .cursor/rules,可以进版本控制;AGENTS.md 也可作为更简单的根目录说明文件。
示例:
---
description: React 组件规范
globs: apps/web/**/*.tsx
alwaysApply: false
---
- 新组件使用 TypeScript 函数组件。
- 样式优先复用现有 Tailwind token。
- 修改 UI 时同步检查移动端布局。
- 不要引入新的状态管理库,除非用户明确要求。
建议把代码风格、目录边界、测试命令、安全限制和“不要做什么”写进去。这样每次开新任务时,Cursor 不必重新猜团队偏好。
图片来源:POPMARS 自制规则示例图,避免复制官方文档截图。
Cursor 价格与国内使用提醒
截至 2026 年 4 月 30 日,Cursor 官方价格页显示个人版包含 Hobby 免费、Pro 每月 20 美元、Pro+ 每月 60 美元、Ultra 每月 200 美元;团队版 Teams 为每用户每月 40 美元,Enterprise 需联系销售。由于价格、额度和模型策略可能变动,发布前应再次打开官方价格页确认。
国内读者还要注意:不要购买共享号或代充;公司代码敏感时先确认隐私、数据保留和团队设置;涉及付费计划时用当天汇率估算人民币成本,不要把历史汇率写成固定价格。
避坑清单与 POPMARS 下一步阅读
- 先 Ask 后 Agent,不要一上来让 AI 大改;
- 每个任务都写清目标、范围、验收和禁止事项;
- 用
.cursor/rules或AGENTS.md固化团队约定; - 让 Agent 跑最小测试,但最终由你 review diff;
- 对价格、benchmark、功能状态保留日期和来源;
- 下一步可阅读 POPMARS 的 AI 编程助手对比与 Rules 模板文章。
想继续看 AI 编程工具的实战教程?订阅 POPMARS,我们会持续更新 Cursor、Windsurf、Claude Code 与开源 Agent 工作流。相关内链计划:/ai-tools/cursor-vs-windsurf-vs-claude-code/、/tutorials/cursor-rules-agents-md-template/、/tutorials/ai-coding-agent-code-review-checklist/。
Cursor 的价值不是替你承担责任,而是压缩“读项目—改代码—跑命令—修错误”的循环。会用 Cursor 的人,通常不是提示词最玄的人,而是最会定义验收标准、最认真 review 的人。
来源与时效说明
| Source | Use in article | Freshness / risk note |
|---|---|---|
| Cursor Composer 2 official blog | Composer 2 availability, token pricing, vendor-reported benchmark table, and model context. | Vendor source; benchmark claims are framed as Cursor-reported, not independent proof. |
| Cursor 3.0 changelog and Chinese changelog | Agents Window, parallel agents, worktrees, cloud / remote SSH, /best-of-n, and Chinese terminology. | Official product source; checked again on 2026-04-30. |
| Cursor Codebase Indexing docs | Embeddings-based indexing, automatic / incremental indexing, settings path, and ignore files. | Official docs; exact UI labels can change. |
| Cursor Rules docs | .cursor/rules, User Rules, Project Rules, AGENTS.md, and durable instruction patterns. | Official docs; note details can change as Cursor evolves. |
| Cursor Chat / Agent overview | Agent capability framing: coding tasks, terminal commands, and edits. | Official docs; used for capability boundaries, not success guarantees. |
| Cursor pricing page | Hobby, Pro, Pro+, Ultra, Teams, and Enterprise pricing snapshot. | Pricing can change; rechecked on 2026-04-30. |
| Composer 2 Technical Report | Public paper record for Composer 2 training and benchmark context. | Authored by Cursor researchers; not neutral user evidence. |
| Terminal-Bench 2.0 Leaderboard | Context for Terminal-Bench as a terminal-agent benchmark. | Independent benchmark site; leaderboard values can update. |
| SWE-bench Multilingual | Context for multilingual software-engineering benchmark claims. | Benchmark page can update; do not overstate ranking claims. |
Newsletter
把实用 AI 工作流发到你的邮箱。
每周获取 POPMARS 的 AI 工具、工作流拆解和可复用模板。