工具条目首选
Cursor
基于 VS Code 的 AI IDE：补全、对话、Agent 和代码在同一个窗口，改动以 diff 呈现。
- 最后审阅
适合
- 想边看代码边和 AI 协作、随时接受或回滚每一处改动的人
- 已经习惯 VS Code，想几乎零迁移成本换到 AI IDE
- 日常小步迭代：改样式、补功能、修 bug
不适合
- 想把 Agent 嵌进脚本或 CI 的场景（用 CLI 更合适）
- 只用一个固定模型、预算敏感、用量难以预估的团队需要先评估计费方式
Cursor 是目前最普及的 AI IDE。它从 VS Code 分支而来，扩展、快捷键和设置基本都能直接沿用，所以从普通编辑器切过来几乎没有门槛。
为什么是首选
- 反馈最快。 Tab 补全会预测你接下来要改的几行，对话和 Agent 的改动直接以 diff 出现在当前文件里，接受、拒绝、回滚都是一次点击。对“会一点代码”的人，这是理解 AI 在做什么最直观的方式。
- 上下文机制完整。 项目根目录的 AGENTS.md 会被直接读取；需要按目录或文件类型生效的规则，写成
.cursor/rules/下带 frontmatter 的.mdc文件。 - 支持 MCP。 可以把浏览器、数据库、文档检索等外部能力接给 Agent。
需要知道的取舍
- 规则文件的格式要对。
.cursor/rules/里的规则必须是带 frontmatter 的.mdc文件，普通.md不会生效；旧的单文件.cursorrules已不在官方文档里，新项目不要再用。 - 规则只对 Cursor 生效。 跨工具通用的说明放进 AGENTS.md，
.mdc只写 Cursor 专属、需要限定作用范围的规则。
上手
- 从官网下载安装，首次启动时可以导入 VS Code 的设置和扩展。
- 在项目根目录放一份 AGENTS.md。
- 把下方的纪念品保存为
.cursor/rules/project.mdc，再按项目改写。
纪念品
带走给你的 AI
把这份 .cursor/rules/project.mdc 放进项目，或直接粘贴给 AI 编程助手。
--- description: 本项目的通用约定：改动范围、验证方式与禁止事项 alwaysApply: true --- - 跨工具通用的说明以根目录 AGENTS.md 为准；本文件只补充 Cursor 专属的约定。 - 一次只处理一个任务。改动前先说明要改哪些文件，再动手。 - 每次改动后运行 `pnpm check`；失败时先修复，不要跳过或放宽断言。 - 新增依赖前先检查项目里是否已有能用的库，并说明理由。 - 不要修改 `pnpm-lock.yaml` 以外的锁文件，不要手动编辑生成代码。