主题
Cursor
Cursor 是面向开发者的 AI 代码编辑器和多端编码 Agent 平台,基于 VS Code 体验扩展出 Agent、Tab、代码库理解、CLI、后台 Agent、PR 审查和 MCP 等能力。
作用说明
Cursor 的定位不是单一的代码补全插件,而是一套围绕「写代码、理解代码、委托任务、审查变更」展开的 AI 编程环境:
- 桌面 IDE: 基于 VS Code 风格,支持导入 VS Code 配置和插件习惯
- Agent: 在编辑器中读取代码、修改文件、运行命令并处理多步任务
- Tab / 补全: 根据上下文预测下一步编辑,适合高频小改动
- CLI: 在终端、脚本、CI 和其他编辑器中运行 Cursor Agent
- Bugbot: 面向 GitHub PR 的 AI 代码审查能力
- Rules: 通过
.cursor/rules、用户规则或AGENTS.md给 Agent 提供持久约束 - MCP: 接入 GitHub、Linear、Figma、Playwright、Sentry、Vercel 等外部工具
- 协作入口: 可从 GitHub、Slack、Linear、JetBrains IDEs 等位置启动后台 Agent
适用人群:希望在图形化 IDE 中使用 AI Agent,同时保留 VS Code 操作习惯、插件生态和可视化代码审查流程的开发者。
环境要求
- 系统:macOS / Windows / Linux
- 一个可登录的 Cursor 账号
- Git
- 推荐项目中维护
AGENTS.md或.cursor/rules,用于固定项目规范 - 如需使用 CLI,Windows 推荐在 WSL 中安装
安装
桌面版
打开下载页:
text
https://cursor.com/downloadCursor 桌面应用提供 macOS、Windows、Linux 安装包。Windows 可选择 x64 / ARM64,并区分 System / User 安装包。
安装后首次启动会引导完成:
- 登录账号
- 选择键盘快捷键
- 选择主题
- 设置终端偏好
- 可按需导入 VS Code 设置
CLI
Cursor CLI 适合在终端、自动化脚本、CI 或非 Cursor 编辑器中运行 Agent。
bash
curl https://cursor.com/install -fsS | bash验证安装:
bash
cursor-agent --version启动 Agent:
bash
cursor-agent手动更新:
bash
cursor-agent update
# 或
cursor-agent upgrade官方 CLI 安装文档说明该方式适用于 macOS、Linux 和 Windows WSL。
核心功能
Agent
Agent 适合处理需要跨文件理解和修改的任务,例如:
- 解释一个模块的实现
- 修复 Bug 并补充测试
- 重构组件、服务或工具函数
- 根据现有代码风格新增功能
- 运行命令并根据结果继续调整
提示词建议:
text
先阅读当前模块的数据流,不要直接改代码。列出你准备修改的文件和原因。text
修复登录页 token 刷新失败的问题,完成后运行相关测试。Tab 与补全
Tab 更适合连续的小步编辑,例如补全相邻代码、更新重复结构、补齐类型和测试断言。它和 Agent 的区别是:
| 能力 | 适合场景 |
|---|---|
| Tab | 当前文件或近邻上下文的小步修改 |
| Agent | 跨文件、多步骤、需要命令验证的任务 |
CLI
CLI Agent 具备文件操作、搜索、运行 Shell 命令等能力,并会读取项目中的规则配置。官方文档说明 CLI 会自动检测并使用 IDE 中配置的 mcp.json,也会读取项目根目录的 AGENTS.md 和 CLAUDE.md。
适合场景:
- 在终端中处理代码任务
- 在 GitHub Actions 或脚本中执行自动化检查
- 在 JetBrains、Vim、终端编辑器等非 Cursor 场景中使用 Agent
Bugbot
Bugbot 是 Cursor 的 PR 审查能力,用于发现 Pull Request 中的 bug、安全问题和代码质量问题。
常见用法:
- PR 更新时自动审查
- 在 PR 中评论
cursor review手动触发 - 在 PR 中评论
bugbot run手动触发 - 通过
.cursor/BUGBOT.md提供项目级审查规则
Rules 与项目约束
Cursor 支持多种规则来源:
| 类型 | 位置 | 用途 |
|---|---|---|
| Project Rules | .cursor/rules | 随项目版本控制,按文件或任务范围应用 |
| User Rules | Cursor 设置 | 对当前用户所有项目生效 |
AGENTS.md | 项目根目录 | 用 Markdown 写 Agent 指令 |
.cursorrules | 项目根目录 | 旧格式,官方建议迁移到 Project Rules |
推荐在项目中写入:
markdown
# 项目规则
- 默认使用中文回复
- 修改代码前先说明计划
- 前端使用 Vue 3 + TypeScript + Vite
- 修改后运行 npm run docs:build 验证
- 不要改动无关文件MCP
Cursor 支持 MCP(Model Context Protocol),可以把外部服务接入 Agent。官方 MCP 目录中包含 GitHub、Linear、Figma、Playwright、Sentry、Vercel、GitLab、PostHog、Stripe、Shopify、Context7 等服务。
适合场景:
- 让 Agent 读取设计稿或产品需求
- 用 Playwright 验证前端页面
- 查询 GitHub issue / PR / Actions
- 连接 Sentry、Datadog 等排查线上问题
- 使用 Context7 等文档源降低 API 幻觉
基本工作流
打开 Cursor,登录账号
打开项目目录
先让 Agent 阅读项目:
text阅读这个项目的目录结构、构建命令和主要技术栈,总结给我,暂时不要修改文件。补充或创建
.cursor/rules/AGENTS.md用 Agent 处理复杂任务,用 Tab 处理连续小改动
完成后检查 diff,运行测试或构建
如使用 GitHub,可配合 Bugbot 做 PR 审查
与 Claude Code / Codex / Qoder 的差异
| 维度 | Cursor | Claude Code / Codex CLI | Qoder |
|---|---|---|---|
| 形态 | 独立 IDE + CLI + Web/协作入口 | 终端 Agent 为主 | 独立 IDE |
| 编辑体验 | 类 VS Code,适合长期主力编辑器 | 更贴近命令行工作流 | 类 IDE 的 Agentic Coding Platform |
| 任务入口 | IDE、CLI、GitHub、Slack、Linear 等 | 终端、IDE 集成、Web | IDE 内 Chat / Quest |
| 项目规则 | .cursor/rules、AGENTS.md、用户规则 | AGENTS.md / CLAUDE.md 等 | 内置项目上下文与任务模式 |
| 适用场景 | 想把 AI 深度嵌入日常 IDE 的开发者 | 喜欢终端闭环和精细控制的开发者 | 希望开箱即用的独立 AI IDE 用户 |
常见问题
Cursor 是否只是 VS Code 插件?
不是。Cursor 是独立桌面应用,但保留了大量 VS Code 操作习惯和生态迁移能力。
Windows 能否使用?
可以。Cursor 桌面版支持 Windows。CLI 官方安装方式更偏向 macOS、Linux 和 Windows WSL。
Cursor CLI 和桌面版是否共享规则?
官方文档说明 CLI 支持与 IDE 相同的规则系统,并会读取 .cursor/rules、AGENTS.md、CLAUDE.md 等项目规则。
什么时候用 Bugbot?
当团队希望在 GitHub PR 阶段自动发现 bug、安全问题和代码质量问题时使用。它更像 PR 审查补充,不能替代人工 review。
参考链接
- Cursor 官网: https://cursor.com/
- 下载页: https://cursor.com/download
- 官方文档: https://docs.cursor.com/
- Cursor CLI: https://cursor.com/cli
- CLI 安装: https://docs.cursor.com/en/cli/installation
- CLI 使用: https://docs.cursor.com/en/cli/using
- Rules: https://docs.cursor.com/context/rules-for-ai
- MCP Servers: https://docs.cursor.com/en/tools/mcp
- Bugbot: https://docs.cursor.com/en/bugbot
- Slack 集成: https://docs.cursor.com/slack