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、补一个接口、重构一个组件、给页面补测试。

Cursor 教程 2026:Composer 2 与智能体窗口工作流示意图

图片来源: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 来验证。

Cursor 30 分钟实战流程:Ask、计划、Agent 修改、测试、人工 review

图片来源:POPMARS 自制流程图,展示从 Ask 到人工 review 的最小闭环。

第一步:安装、登录、索引代码库

  1. Cursor 官方下载页安装客户端并登录。
  2. 打开一个你能本地运行的项目,最好有 README、测试命令和清晰目录结构。
  3. 等待代码库索引完成。Cursor Codebase Indexing 文档说明,Cursor 会为代码库文件计算 embeddings;新文件会增量索引,状态可在 Cursor Settings > Indexing & Docs 查看。
  4. 把构建产物、日志、大数据文件放进 .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 不必重新猜团队偏好。

Cursor Rules 示例:用 .cursor/rules 固化 React 组件规范

图片来源:POPMARS 自制规则示例图,避免复制官方文档截图。

Cursor 价格与国内使用提醒

截至 2026 年 4 月 30 日,Cursor 官方价格页显示个人版包含 Hobby 免费、Pro 每月 20 美元、Pro+ 每月 60 美元、Ultra 每月 200 美元;团队版 Teams 为每用户每月 40 美元,Enterprise 需联系销售。由于价格、额度和模型策略可能变动,发布前应再次打开官方价格页确认。

国内读者还要注意:不要购买共享号或代充;公司代码敏感时先确认隐私、数据保留和团队设置;涉及付费计划时用当天汇率估算人民币成本,不要把历史汇率写成固定价格。

避坑清单与 POPMARS 下一步阅读

想继续看 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 的人。

来源与时效说明

SourceUse in articleFreshness / risk note
Cursor Composer 2 official blogComposer 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 changelogAgents 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 docsEmbeddings-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 overviewAgent capability framing: coding tasks, terminal commands, and edits.Official docs; used for capability boundaries, not success guarantees.
Cursor pricing pageHobby, Pro, Pro+, Ultra, Teams, and Enterprise pricing snapshot.Pricing can change; rechecked on 2026-04-30.
Composer 2 Technical ReportPublic paper record for Composer 2 training and benchmark context.Authored by Cursor researchers; not neutral user evidence.
Terminal-Bench 2.0 LeaderboardContext for Terminal-Bench as a terminal-agent benchmark.Independent benchmark site; leaderboard values can update.
SWE-bench MultilingualContext for multilingual software-engineering benchmark claims.Benchmark page can update; do not overstate ranking claims.