2.2 Cursor 使用指南
学习建议：Cursor 是目前最强大的 AI 编程工具之一。建议花 1-2 天时间熟悉核心功能，然后在实际项目中逐步提升熟练度。
🆕 Cursor 2.0 重大更新（2025 年 10 月）
重磅升级！ Cursor 在 2025 年 10 月 29 日发布了 2.0 版本，带来革命性的多智能体协作功能。
如果你还在用旧版本，强烈建议升级: https://cursor.com/download
核心新特性
1. Composer 模型 - 速度提升 4 倍 ⚡
什么变了：
- 🚀 响应速度：从 30-60 秒 → 大部分请求 30 秒内完成
- 💰 成本更低：比直接用 OpenAI API 便宜很多
- 🧠 更强理解：内置代码库语义搜索，理解大型项目更准确
对新手的意义：
不用再傻等 AI 的回复了，学习效率直接翻倍！
2. 多智能体并行 - 同时开发多个功能 🤖🤖🤖
场景案例:
假设你在做一个网站，需要：
- Agent 1: 写首页的 HTML 结构
- Agent 2: 设计导航栏样式
- Agent 3: 开发登录功能
- Agent 4: 配置数据库
以前: 只能一个一个来，4 个任务要 4 小时 现在: 4 个 Agent 同时干，1 小时搞定！
新手注意:
- 刚开始别用这么多 Agent，容易乱
- 建议先用单 Agent 熟练后，再尝试 2-3 个并行
- 每个 Agent 有独立的工作空间(git worktree)，不会互相干扰
3. 内置浏览器 - AI 可以自己测试代码 🌐
以前的流程 (7 步，容易出错):
- AI 写代码
- 你复制到编辑器
- 保存文件
- 打开浏览器刷新
- 发现有 bug
- 回到 AI 继续改
- 重复 2-6…
现在的流程 (3 步，AI 自己搞定):
- AI 写代码 + 自己在内置浏览器里测试
- 发现问题自己改
- 改好后再给你看
对新手的意义:
AI 可以自己测试自己的代码了，给你的版本更可靠！减少你的调试时间。
4. 增强型代码审查 👀
改进点:
- 更清晰的 diff 视图(能一眼看出改了什么)
- 可以快速查看每个文件的改动摘要
- 支持直接在审查界面修改代码
如何升级到 Cursor 2.0?
步骤 1: 下载最新版本
访问： https://cursor.com/download
步骤 2: 安装并重启
- 安装包会自动覆盖旧版本
- 你的设置会自动迁移，不用担心
步骤 3: 验证版本
打开 Cursor → 菜单栏 Help → About Cursor
确认版本号 ≥ 2.0.0
步骤 4: 体验新功能
- Composer 模型会自动使用，无需额外配置
- 多 Agent 功能需要在设置中开启
- 浏览器工具在需要时会自动调用
2.0 vs 1.x 对比 (新手关心的)
| 功能 | 1.x 版本 | 2.0 版本 | 影响 |
|---|---|---|---|
| 生成速度 | 30-60 秒 | < 30 秒 | 学习效率提升 2 倍 |
| 多任务处理 | 只能串行 | 最多 8 个并行 | 复杂项目效率提升 4 倍 |
| 代码测试 | 需要手动 | AI 自动测试 | 减少 50%调试时间 |
| 费用 | 较高 | 更低 | 同样预算能做更多项目 |
给新手的建议:
- 如果你刚开始学: 直接下载 2.0，享受最快的速度
- 如果你已在用 1.x: 尽快升级，新特性会让你效率翻倍
- 多 Agent 功能: 等你做了 3-5 个项目再用，不要一开始就尝试
- Composer 模型: 自动使用，不用任何设置，享受就行！
Cursor 安装和配置
第一次打开 Cursor，10 分钟做完这三步，就能开始对话写代码：
步骤 1：下载安装
- 访问官网：https://cursor.com
- 下载安装包：根据你的系统（macOS/Windows/Linux）下载对应版本
- 安装并登录：运行安装程序，完成后启动并登录账号
步骤 2：确认模型配置
- 打开设置：
Settings → AI → Model - 选择 AI 模型：
- 付费用户：选择 GPT-4 或 Claude（推荐）
- 免费用户：使用默认模型也能完成入门练习
步骤 3：完成 Hello World 测试
- 打开对话：按
Command/Ctrl + L打开 AI 对话面板 - 输入测试请求：
帮我创建一个打印 Hello World 的 JavaScript 脚本，并告诉我如何运行 - 运行测试：复制 AI 提供的命令到内置终端执行
可选配置
进阶配置：如果你有 API 密钥，建议配置以获得更好的控制权和成本优势。
- API 密钥配置：
Settings → AI → API Keys填入你的 OpenAI 或 Anthropic API 密钥 - VS Code 设置迁移：
Settings → General → Import VS Code Settings一键同步主题和快捷键 - 界面主题：
Settings → Appearance选择你喜欢的主题和字体
Cursor 核心功能
记住这几个核心功能，基本就拿到了 Cursor 的「万能遥控器」。
功能 1：AI 对话（Chat）
快捷键：Command/Ctrl + L
主要用途：
- 🤔 询问代码问题和概念
- ✨ 生成新的代码片段
- 📖 解释现有代码逻辑
- 🔧 重构和优化代码
对话示例：
用户: 帮我创建一个Next.js项目的基础结构
Cursor: 我会帮你创建一个基础的 Next.js 项目结构...
[生成项目文件和代码]
用户: 现在添加一个首页，包含导航栏和Hero区域
Cursor: 好的，我会创建首页组件...
[生成页面组件代码]对话技巧：
- 提供具体的上下文信息
- 分步骤提出复杂需求
- 及时反馈和修正结果
- 保持对话的连贯性
功能 2：智能代码补全
触发方式：输入代码时自动触发
核心特点：
- 🧠 上下文感知理解
- 📝 多行代码补全
- 💡 智能建议推荐
补全示例：
// 你输入：
function calculate
// Cursor 自动补全：
function calculateTotal(items) {
return items.reduce((sum, item) => sum + item.price, 0);
}使用建议：看到补全建议时，先确认变量名、数据结构是否与你的项目一致，再决定接受或拒绝。不要盲目接受所有补全。
功能 3：快速编辑（Cmd K）
快捷键：Command/Ctrl + K
适用场景：
- ✏️ 快速修改选中代码
- 📝 添加详细注释
- 🔄 重构代码结构
使用步骤：
- 选中需要修改的代码
- 按
Cmd + K打开编辑面板 - 输入具体的修改指令
- AI 会直接修改代码
实用示例：
选中一段处理数据的代码 → Cmd K → "添加错误处理机制" → AI自动添加 try-catch 结构修改技巧：如果 AI 的修改结果不满意，可以直接按 Command/Ctrl + Z 撤销，然后换个更具体的说法重新来。
功能 4：AI Agent（@符号功能）
触发方式：在对话中输入 @ 符号
强大功能：
@Files：引用项目文件进行讨论@Docs：查询技术文档和 API@Web：搜索网络获取最新信息@Git：执行 Git 相关操作
使用示例：
@Files app/page.tsx 帮我优化这个文件的性能
@Docs Next.js 如何配置环境变量？
@Web 最新的 React 19 有什么新特性？
@Git 帮我查看最近的提交历史引用技巧：引用文件时，记得补充说明当前页面的状态和你的目标效果，这样 AI 才能更准确地理解需求。
Cursor Rules 项目配置
什么是 Cursor Rules？
项目级 AI 指令：.cursorrules 文件是项目的「说明书」，告诉 AI 你的技术栈、代码规范和偏好，大幅提升 AI 生成代码的准确性。
创建 .cursorrules 文件
在项目根目录创建配置文件：
# 在项目根目录创建
touch .cursorrules配置文件示例
# 项目技术栈
- Next.js 15
- TypeScript
- Tailwind CSS
- shadcn/ui
# 代码规范
- 使用函数组件和 Hooks
- 使用 TypeScript 类型注解
- 使用 Tailwind CSS 编写样式
- 组件文件使用 PascalCase 命名
# AI 行为准则
- 生成代码时添加详细注释
- 优先考虑性能和SEO
- 遵循Next.js最佳实践
- 使用shadcn/ui组件库
# 禁止事项
- 不要使用 class 组件
- 不要使用 inline styles
- 不要忽略TypeScript错误
- 不要生成未使用的import语句使用技巧
重要提醒：配置完 .cursorrules 后，在对话中记得提醒 AI 遵循项目规范：「请遵循 .cursorrules 中的规范」。有时需要你「唤醒记忆」。
Cursor 使用技巧
技巧 1：上下文引用
# 引用特定文件进行讨论
@Files components/Header.tsx 帮我修改导航栏样式
# 引用多个文件保持一致性
@Files app/page.tsx @Files components/Hero.tsx
帮我让这两个文件的样式保持一致技巧 2：分步骤开发
渐进式开发：将复杂任务分解为多个步骤，逐步完成，每步确认结果后再进行下一步。
# 第一步：项目结构
帮我创建React项目的基础结构
# 等第一步完成后
# 第二步：核心页面
现在添加首页的Hero区域
# 第三步：功能完善
添加联系表单和交互功能技巧 3：让 AI 解释代码
# 使用步骤：
1. 选中需要解释的代码
2. 按 Command + L 打开对话
3. 输入："解释这段代码在做什么"技巧 4：调试和错误处理
错误处理流程：遇到报错时，提供完整的错误信息和预期行为，让 AI 更好地定位问题。
# 标准错误提问格式：
我遇到了这个错误：
[粘贴完整的错误信息]
我原本预期的行为是：
[描述你期望的结果]
请帮我分析原因并提供修复方案。实战练习项目
练习 1：个人介绍页面（1 小时）
目标：创建一个简单的个人介绍页面
步骤：
- 创建基本的 HTML 结构
- 添加个人信息内容
- 使用 CSS 美化样式
- 添加响应式设计
Cursor 对话示例：
帮我创建一个个人介绍页面，包含：
- 个人照片
- 姓名和职业
- 技能介绍
- 联系方式练习 2：待办事项应用（2-3 小时）
目标：创建一个功能完整的待办事项管理应用
功能要求：
- 添加新任务
- 标记完成状态
- 删除任务
- 数据持久化
开发策略：
# 第一步：基础结构
帮我创建一个待办事项应用的基础结构
# 第二步：核心功能
现在添加添加任务和完成任务的功能
# 第三步：数据存储
添加本地存储功能，让数据在刷新后不丢失
# 第四步：界面优化
美化界面，添加动画效果常见问题解决
问题 1：AI 不理解我的需求
解决方案：
- 提供更具体的上下文信息
- 分步骤描述复杂需求
- 使用代码示例说明期望结果
问题 2：生成的代码有错误
解决方案：
- 复制完整错误信息给 AI
- 说明预期的正确行为
- 要求 AI 逐步调试和修复
问题 3：AI 响应速度慢
解决方案：
- 检查网络连接
- 简化对话上下文
- 使用更具体的提问方式
进阶学习路径
学习建议：掌握基础后，建议在实际项目中持续使用和优化 Cursor 的使用技巧。
第 1 周：基础熟练
- 熟练使用核心快捷键
- 掌握基本对话技巧
- 完成简单练习项目
第 2-3 周：项目实战
- 在真实项目中使用 Cursor
- 学习复杂需求的表达方式
- 掌握调试和优化技巧
第 1 个月：高级技巧
- 熟练使用@符号功能
- 配置项目的。cursorrules
- 形成个人化的工作流程