Cursor AI 完全指南：让 AI 帮你写代码

什么是 Cursor？

Cursor 是一款基于 VS Code 的 AI 代码编辑器，在短短 16 个月内就获得了超过 100 万用户和 36 万付费用户。它不仅仅是一个代码补全工具，而是将 AI 深度集成到整个开发工作流中的智能 IDE。

Cursor vs VS Code + Copilot

特性	Cursor	VS Code + Copilot
代码补全	Tab 补全	Copilot 补全
多文件编辑	Composer 模式	不支持
Agent 模式	自主探索项目	不支持
上下文理解	深度理解整个代码库	单文件为主
并行代理	多个 Agent 同时工作	不支持

我从 VS Code 转到 Cursor 的故事

说起来，我转到 Cursor 的过程还挺曲折的。

2025 年初，我还在用 VS Code + GitHub Copilot 的组合。当时已经觉得 Copilot 很好用了——代码补全能省不少时间。但有一天，一个朋友给我演示了 Cursor 的 Composer 模式，当场把我"打服"了。

他打开 Composer，输入了一段话："把这个 Express 项目的用户认证从 JWT 改成 OAuth2，保持 API 接口不变。" 然后 Cursor 自动识别了 6 个需要修改的文件，一次性全部改完了。而且代码质量很高，几乎不需要手动调整。

这在 VS Code + Copilot 里是不可能做到的——Copilot 一次只能看一个文件。

当天晚上我就下载了 Cursor。迁移过程出奇地顺利，因为 Cursor 本身就是基于 VS Code 的，所有配置一键导入。到现在大概用了一年了，已经完全回不去了。我身边的开发者朋友，大概有 70% 都转到了 Cursor。

安装 Cursor

下载安装

访问 cursor.com 下载对应系统版本：

macOS：支持 Intel 和 Apple Silicon
Windows：支持 Windows 10/11
Linux：支持主流发行版

迁移 VS Code 配置

Cursor 基于 VS Code，可以一键导入你的配置：

打开 Cursor
点击 File → Import VS Code Settings
选择要导入的内容（扩展、主题、快捷键等）

核心功能详解

1. Tab 补全

最基础但也最常用的功能，按 Tab 接受 AI 建议：

// 输入 function calculate
function calculateTotalPrice(items) {
  // Tab 补全会自动生成函数体
  return items.reduce((sum, item) => sum + item.price * item.quantity, 0);
}

技巧：

写好函数签名和注释，AI 能更准确理解意图
按 Esc 拒绝建议，按 Tab 接受

2. 内联编辑 (Cmd+K / Ctrl+K)

选中代码后按 Cmd+K，用自然语言描述修改：

选中代码 → Cmd+K → 输入 "添加错误处理" → Enter

适用场景：

快速重构一小段代码
添加类型注解
修复 bug
优化性能

3. Composer 模式 (Cmd+I / Ctrl+I)

这是 Cursor 的杀手级功能，可以跨多个文件进行编辑：

Cmd+I 打开 Composer → 描述需求 → AI 自动修改相关文件

示例提示词：

创建一个用户认证系统，包括：
1. 登录页面组件 (src/pages/Login.tsx)
2. 注册页面组件 (src/pages/Register.tsx)
3. 认证 API 路由 (src/api/auth.ts)
4. 用户状态管理 (src/store/user.ts)

Composer 会自动创建/修改所有相关文件。

4. Agent 模式

Agent 模式让 AI 自主探索你的项目：

在 Composer 中点击 Agent 按钮
描述你的需求
AI 会自动：
- 搜索相关代码
- 理解项目结构
- 执行终端命令
- 修改多个文件

与 Composer 的区别：

Composer：你指定文件，AI 编辑
Agent：AI 自己决定需要看哪些文件

5. 并行代理 (Cursor 2.0)

Cursor 2.0 支持多个 Agent 同时工作：

Agent 1：重构数据库层
Agent 2：修复测试用例
Agent 3：优化 UI 组件

使用 Git Worktrees 隔离，互不干扰。

高级技巧

1. 使用 @ 引用上下文

在对话中使用 @ 引用文件、文件夹或文档：

@src/utils/api.ts 这个文件的错误处理逻辑有问题，帮我优化
@docs/api.md 根据这个文档生成 TypeScript 类型定义
@codebase 在整个代码库中搜索所有使用了 deprecated API 的地方

2. 配置 Rules

在项目根目录创建 .cursorrules 文件，定义项目规范：

# .cursorrules

你是一个 Next.js 14 专家，请遵循以下规范：

## 代码风格
- 使用 TypeScript 严格模式
- 组件使用函数式写法
- 使用 Tailwind CSS 进行样式处理

## 命名规范
- 组件：PascalCase
- 函数：camelCase
- 常量：UPPER_SNAKE_CASE

## 禁止事项
- 不要使用 any 类型
- 不要使用 class 组件
- 不要直接修改 state

3. Plan 模式

对于复杂任务，让 AI 先制定计划：

请先制定一个详细的实现计划，包括：
1. 需要修改的文件列表
2. 每个文件的具体修改内容
3. 潜在的风险和注意事项

确认计划后再开始实现。

4. 触发深度思考

使用特定关键词触发更深入的分析：

关键词	思考深度
think	基础思考
think hard	深度思考
think harder	更深度思考
ultrathink	最深度思考

快捷键速查

快捷键	功能
`Tab`	接受补全建议
`Cmd+K`	内联编辑
`Cmd+I`	打开 Composer
`Cmd+L`	打开聊天面板
`Cmd+Shift+I`	新建 Composer 会话
`Cmd+.`	显示快速修复
`@`	引用文件/上下文

订阅方案

方案	价格	功能
Free	$0/月	2000 次补全，50 次慢速请求
Pro	$20/月	无限补全，500 次快速请求
Business	$40/月	团队功能，管理后台

最佳实践

1. 结合 Git 使用

# 在让 AI 大改之前，先提交当前状态
git add . && git commit -m "checkpoint before AI refactor"

# AI 改完后，用 diff 审查
git diff

# 不满意可以回滚
git checkout .

2. 渐进式修改

不要一次性让 AI 改太多，分步骤进行：

❌ 帮我重构整个项目的状态管理

✅ 第一步：帮我把 UserContext 改成 Zustand
✅ 第二步：迁移 CartContext
✅ 第三步：迁移 ThemeContext

3. 提供足够上下文

❌ 帮我写一个表单

✅ 帮我写一个用户注册表单，要求：
- 字段：邮箱、密码、确认密码、用户名
- 使用 React Hook Form + Zod 验证
- 样式使用 Tailwind CSS
- 提交到 /api/auth/register
- 显示加载状态和错误信息

常见问题

Q: Cursor 会泄露我的代码吗？

Cursor 提供 Privacy Mode，开启后代码不会发送到服务器训练。企业版还支持本地部署。

Q: 如何使用自己的 API Key？

Settings → Models → 添加你的 OpenAI/Anthropic API Key

Q: Cursor 和 Claude Code 哪个更好？

Cursor：图形界面，适合可视化编辑
Claude Code：终端工具，适合命令行爱好者

两者可以配合使用。

总结

Cursor 通过 Composer 和 Agent 模式，将 AI 编程从"补全代码"提升到了"理解意图、自主执行"的新高度。

推荐学习路径：

先熟练使用 Tab 补全
掌握 Cmd+K 内联编辑
学会 Composer 多文件编辑
最后尝试 Agent 模式