Cursor：AI 原生代码编辑器

时效说明：本文内容以 2026 年 3 月为基准。Cursor 版本迭代极快，使用前建议查阅最新文档 cursor.com/docs。

用过 IntelliJ IDEA 的人都知道，好用的 IDE 能省多少事。Cursor 想做的事比这更激进——不只是让编辑器更聪明，而是让 AI 真正接管编码里那些繁琐的部分：多文件修改、跨模块重构、甚至直接帮你把一个功能从头写完。

1.1 Cursor 是什么

官方定位（来自 cursor.com/docs）：

Cursor is an AI editor and coding agent. Use it to understand your codebase, plan and build features, fix bugs, review changes, and work with the tools you already use.

Cursor 是由 Anysphere 公司开发的 AI 原生代码编辑器，2024 年起快速成长，截至 2026 年 3 月已发布 v2.6，是当前最主流的 AI 编程工具之一。

1.1.1 与 VS Code 的关系

官方文档明确说明：

Cursor is based upon the VS Code codebase, allowing us to focus on making the best AI-powered coding experience while maintaining a familiar editing environment.

Cursor 是 VS Code 的硬分叉（hard fork）——直接基于 VS Code 源码构建，定期 rebase 到最新 VS Code 版本。这意味着：

• VS Code 的全部插件生态可以直接使用
• 所有快捷键、主题、设置完全兼容
• 提供一键迁移：Settings → General → Account，自动导入 VS Code 的键绑定、扩展、主题

对于 Java 开发者：Cursor 不是 IntelliJ IDEA 的替代品（Java 生态的 Maven/Gradle/Spring 深度集成在 IDEA 里更成熟），但 2026 年 3 月 Cursor 新增了 JetBrains 集成，可以在 IntelliJ IDEA 里直接使用 Cursor 的 Agent 能力，后面会详细说。

1.2 与其他工具的定位差异

简单说：Copilot 是插件，装在你的 IDE 上；Cursor 是编辑器本身，AI 从一开始就是它的一部分，不是后来加进去的。

1.3 四大核心功能

1.3.1 Tab：AI 自动补全

官方描述：

Tab is Cursor's AI-powered autocomplete. It suggests code as you type, based on your recent edits, surrounding code, and linter errors.

Tab 补全以灰色幽灵文字显示在光标前方，按 Tab 接受，按 Esc 拒绝。

与普通代码补全的区别：

• 多行编辑：不只补全当前行，可以同时修改多行、自动添加缺失的 import
• 跨文件编辑：当一个文件的改动需要同步更新另一个文件时，底部会弹出提示
• 基于上下文预测：不只看当前光标位置，还参考你最近的编辑历史和 linter 报错

类比 IntelliJ IDEA：IDEA 的补全是基于语法树的精确补全，Cursor 的 Tab 更像是"预测你接下来要写什么"，适合写新代码，IDEA 的补全在重构已有代码时更精准。

1.3.2 Agent：自主编程模式

Agent 是 Cursor 的核心能力，自 v0.46（2025年2月）起成为默认交互模式。

Agent 由三个部分构成：LLM 模型 + 工具集 + 编排层。

Agent 可以使用的工具（无调用次数上限）：

Checkpoints（检查点）：Agent 工作时自动创建代码库快照，可以一键回滚到任意检查点，独立于 Git，不需要提前 commit。

消息队列：Agent 正在执行任务时，你可以提前排队下一条指令，不用等它完成再输入。

即时打断（Cmd+Enter）：立即将新消息附加到当前工具调用结果，不等当前步骤完成。

1.3.3 Plan Mode：先规划再执行

官方描述：

Plan Mode creates detailed implementation plans before writing any code. Agent researches your codebase, asks clarifying questions, and generates a reviewable plan you can edit before building.

工作流程：

1. Agent 向你提出澄清问题（"你希望新增接口还是修改现有接口？"）
2. 研究代码库，收集相关上下文
3. 生成可编辑的实现计划（Markdown 文件）
4. 你审阅并修改计划
5. 点击"Build"执行

做 Spring Boot 项目的模块重构前，用 Plan Mode 先让 Agent 说说它的理解，能省不少事——改了一半发现方向错了，代价太高。需求模糊、改动涉及多个模块的时候，先规划再动手是个好习惯。

1.3.4 Inline Edit：快速内联修改（Cmd/Ctrl+K）

官方描述：

Inline edit lets you make quick, targeted code changes without opening the chat panel. Select code, describe what you want, and Cursor applies the edit in place.

操作流程：选中代码 → Cmd+K（macOS）或 Ctrl+K（Windows/Linux）→ 输入指令 → 直接应用修改。

注意：User Rules（用户规则）对 Inline Edit 无效，Rules 只作用于 Agent（Chat）模式。

1.4 Rules 配置系统

官方描述：

Rules provide system-level instructions to Agent. They bundle prompts, scripts, and more together, making it easy to manage and share workflows across your team.

Rules 是 Cursor 的"团队规范注入"机制——把你的代码风格、架构约定、禁止操作写进 Rules，Agent 每次回答都会遵守。

1.4.1 四种 Rules 类型

1.4.2 旧格式 vs 新格式

• 旧格式：项目根目录的 .cursorrules 单文件（v0.45 之前，2025年1月前）
• 新格式：.cursor/rules/ 目录下的多文件（v0.45 起，已是推荐格式）

旧格式仍然兼容，但新格式支持多文件管理和按路径自动触发，更灵活。

1.4.3 新格式文件结构

.cursor/rules/
├── java-conventions.mdc      # Java 代码规范（alwaysApply）
├── api-guidelines.md         # API 设计规范
└── backend/
    └── spring-patterns.mdc   # Spring Boot 专项规范（glob 触发）

每个规则文件是独立的 .mdc（或 .md）文件，支持 frontmatter 元数据：

---
globs: src/main/java/**/*.java
alwaysApply: false
---

## Java 代码规范

- 所有 Service 类必须有对应的接口
- 使用 @Slf4j 注解代替手动声明 Logger
- 禁止在 Controller 层写业务逻辑，必须调用 Service
- 所有公开方法必须有 Javadoc，包含 @param 和 @return
- 常量必须定义在独立的 Constants 类中，禁止魔法数字

@JavaConventions.java

三种触发方式：

• alwaysApply: true：每次 Chat 会话自动注入
• 设置 globs：匹配文件时自动注入（如只对 .java 文件生效）
• 两者都不设置：由 Agent 根据 description 判断是否需要

最佳实践：

• 每个规则文件控制在 500 行以内
• 写法像内部文档，提供具体示例而不是抽象原则
• 用 @file.java 引用示例文件，不要复制文件内容进来
• 可以用 /Generate Cursor Rules 命令从对话中自动生成规则

1.5 MCP 集成

MCP（Model Context Protocol，模型上下文协议）是 Anthropic 提出的开放标准，让 Agent 能连接外部工具和数据源。

官方描述：

MCP connects Cursor to external systems and data.

Cursor 支持三种 MCP 传输方式（stdio、HTTP、SSE），支持 OAuth 认证。MCP 工具默认需要用户点击批准。

常见 MCP 使用场景：

• 连接 GitHub，让 Agent 直接操作 PR 和 Issue
• 连接数据库，让 Agent 查询实际数据辅助调试
• 连接 Sentry，让 Agent 直接看生产错误

Cursor v2.5（2026年2月）推出了 Cursor Marketplace，可以一键安装来自 Amplitude、AWS、Figma、Linear、Stripe、Atlassian、Datadog、GitLab 等合作伙伴的 MCP 集成。

1.6 JetBrains 集成（Java 开发者福音）

2026 年 3 月 4 日，Cursor 通过 ACP（Agent Client Protocol，代理客户端协议） 支持在 JetBrains IDE 中使用 Cursor 的 Agent 能力。

也就是说，你不用离开 IDEA，就能用上 Cursor 的 Agent、Plan Mode、Rules。IDEA 的 Maven/Gradle/Spring 集成和调试器还在，Cursor 的 AI 能力也有了。对于主要写 Java 的人来说，这比完全迁移到 Cursor 要现实得多。

注意：截至 2026 年 3 月，JetBrains 集成仍处于早期阶段，功能完整性不如原生 Cursor 编辑器。如果你的主要工作语言是 Java，建议关注后续更新。

1.7 快速上手

1.7.1 安装

从 cursor.com/downloads 下载对应平台的安装包，支持 macOS、Windows、Linux。

从 VS Code 迁移：Settings → General → Account → Import VS Code Settings，一键导入键绑定、扩展、主题、设置。

从 IntelliJ IDEA 迁移：目前没有一键迁移，需要手动重新安装插件。建议先用 Cursor 处理 Python/前端项目，Java 项目继续用 IDEA + JetBrains 集成。

1.7.2 创建第一个 Rules 文件

在项目根目录创建 .cursor/rules/ 目录，新建 project-rules.mdc：

---
alwaysApply: true
---

## 项目规范

**技术栈**：Spring Boot 3.x + MyBatis Plus + MySQL 8.0

**代码规范**：
- 包结构：controller / service / mapper / entity / dto / vo
- Service 层必须有接口，实现类命名为 XxxServiceImpl
- 所有数据库操作通过 Mapper 接口，禁止在 Service 中写 SQL 字符串
- 统一返回 Result<T> 包装类，不直接返回实体对象

**禁止操作**：
- 禁止在 Controller 中写业务逻辑
- 禁止硬编码数据库连接信息
- 禁止使用 System.out.println，必须用 @Slf4j

**Git 规范**：
- commit message 格式：feat/fix/refactor/docs: 简短描述
- 禁止直接 push 到 main 分支

创建后，打开 Chat 面板（Cmd+L 或 Ctrl+L），直接问 Agent 问题，它会自动遵守这些规范。

1.7.3 使用 Agent 完成一个任务

你：在 UserService 中新增一个方法，根据用户 ID 查询用户的所有订单，
    要求分页，返回 PageResult<OrderVO>

Agent：（自动读取项目结构、查找现有的分页实现、生成符合项目规范的代码）

Agent 会自动：

1. 搜索现有的 PageResult、OrderVO 等类
2. 查看 UserService 接口和实现类的现有结构
3. 生成符合项目规范的代码
4. 如果需要新建类，也会自动创建

1.8 定价选择建议

建议：先用免费版体验 Tab 补全和基本 Agent，如果发现用量不够再升级 Pro。对于 Java 开发者，Pro 计划（$20/月）通常已经足够。

1.9 小结

Tab 补全只是 Cursor 的入门功能，真正值钱的是 Agent 模式和 Rules 系统。

用起来之后你会发现，最有用的操作往往是：把项目规范写进 .cursor/rules/ 提交到 Git，然后再也不用每次都跟 Agent 解释"我们项目的规范是……"。Plan Mode 适合改动大的时候先确认方向，省得做到一半发现跑偏了。Java 开发者暂时不想换编辑器的话，JetBrains 集成是个过渡方案，虽然功能还不完整，但够用。

官方文档：cursor.com/docs | 变更日志：cursor.com/changelog