Cursor 教程

Cursor 的优势在于把 AI 代理放进编辑器现场：一边看上下文、一边改代码、一边审查 diff。学习重点是模式选择、规则沉淀和可回滚的迭代节奏。

先选对模式

模式	适合	使用建议
Ask	只读理解、解释代码、规划方案。	用于不确定时先问清楚，不让它直接改文件。
Agent	多文件功能、重构、排错和测试修复。	给清楚目标和验收标准，并频繁 review diff。
Manual	精确小改、局部替换、你已经知道怎么改。	适合减少代理自由度。
Custom	团队或任务特化流程。	把固定工具、权限和提示组合成可复用工作模式。

Rules 是 Cursor 的内容护栏

Cursor Rules 用来给 Agent 和 Inline Edit 提供可复用上下文。项目规则放在 .cursor/rules，可版本化、可按路径或相关性应用；User Rules 放个人偏好；AGENTS.md 适合简单 Markdown 指令；legacy .cursorrules 仍可读但建议迁移。

规则写法建议：
- 一条规则只解决一个场景，例如 React 组件、API handler、数据库迁移。
- 写具体例子和禁止项，不写“代码要优雅”这种空话。
- 超过几百行就拆分，避免每次会话都塞入无关上下文。
- 规则变化后，用一个小任务验证它是否真的影响 Agent 行为。

日常闭环

用 Ask 读问题和相关代码，确认改动范围。
切到 Agent 实现一个小闭环，不要一次塞多个目标。
用 Review Diffs 看每个文件的改动理由，必要时回到 checkpoint。
运行测试或手动验收，把失败输出作为下一轮上下文。
把重复纠正沉淀为 .cursor/rules、AGENTS.md 或 CLI 脚本。

CLI 与 MCP

Cursor CLI

适合脚本、CI、headless 总结、批量 review 和从终端继续会话。

MCP

把数据库、浏览器、设计系统、文档库或内部工具接入 Agent 的工具链。

AGENTS.md

让 Cursor、Codex 等多个代理共享一份基础项目指令。

常见问题

Cursor Agent 和 Ask 怎么选？

不确定目标或风险时先用 Ask；需要多文件修改、运行命令或自动修复时用 Agent；已经知道精确改法时用 Manual。

Rules 应该写多少？

先写最常被重复说明的 3 到 5 条规则，每条规则聚焦一个场景，并用真实任务验证。规则太大反而会污染上下文。

参考来源

内容基于 Cursor 官方 Agent、Rules、CLI、MCP 文档和 changelog 整理，并改写为中文教程站结构。