第一部分：安装 → 5分钟搞定
- 从 cursor.com 下载安装包（Windows/Mac/Linux都支持）
- 安装过程与VS Code一模一样（就是VS Code的分支）
- 首次启动会问是否从VS Code导入设置、扩展、快捷键→ 强烈建议选"是"，零迁移成本
- 登录后在设置中配AI模型：默认选 claude-4-sonnet（中文理解和编码质量最佳），一心想用OpenAI的可以选 gpt-4o
到这里Cursor已经可以用了——Tab补全会自动开始工作。但这时候你只用了10%。
第二部分：四种交互模式（90%的人只用了一种）
| 功能 | 快捷键 | 能力 | 什么时候用 |
|---|---|---|---|
| Tab 补全 | Tab | AI预测下一行代码 | 日常写代码时的自动补全 |
| 内联聊天 | Ctrl+L | 选中代码→向AI提问/让AI改 | 改bug、解释代码、重构一个函数 |
| Composer | Ctrl+I | 跨文件代码生成和修改 | 加新功能、改多个文件的重构 |
| Agent模式 | Composer内切换 | AI自主完成多步骤任务 | 写功能→跑测试→修bug→再测 |
效率差距：只用Tab补全 = 快30%。加了内联聊天 = 快2倍。学会Composer = 快5倍。用上Agent + .cursorrules = 快10倍。
第三部分：Composer — Cursor的"真·核心功能"
Composer是Cursor区别于所有其他AI编程工具的功能。它不只是给你一段代码——它是理解你的整个项目，然后修改多个文件。
Composer基础使用（30秒学会）
按 Ctrl+I → 输入自然语言需求：
"在项目的Navbar组件里加一个深色模式切换按钮，同步更新theme.css里的CSS变量，还要更新localStorage里保存的用户偏好"
Composer会：自动找到 Navbar 组件 → 理解 theme.css 里的 CSS 变量 → 生成修改计划 + diff → 你确认后一次性应用到 3 个文件。
Composer的三个关键技巧
技巧一：用 @ 引用精确指定上下文
在Composer输入框里打 @ 可以看到这些选项：
- @Files — 引用特定文件。"@Navbar.tsx @theme.css @useDarkMode.ts 实现深色模式"
- @Folders — 引用整个目录。"@components/ 把所有组件的PropTypes加上"
- @Code — 引用某段代码。"@ 这段排序逻辑 改成支持多字段排序"
- @Web — 引用网页内容。"@ nextjs.org/docs/app-router 按照最新文档重写路由"
用了@和不用的质量差距是巨大的。@ 告诉AI"你只需要关注这些东西"——没有@，AI在一个10万行项目里到处猜上下文，效果打五折。
技巧二：分批修改而不是一把梭
❌ "帮我重构整个用户系统" → AI会迷失
✅ "先重构User数据模型" → 确认 → "再更新API层" → 确认 → "最后改前端组件"
每步确认后再进行下一步。这不是慢——每步确认一次比全部改完发现要回滚快得多。
技巧三：给约束条件
在需求后面加上限制："不改已有API" "保持向后兼容" "TypeScript strict模式" "不加新的npm包"。
约束越具体，AI越不会"过度优化"。不加约束的AI像个太热情的建筑师——顺便把你房子也推了重建了。
第四部分：Agent模式 — 让AI自己来
2026年Cursor的Agent模式已经相当成熟——它不只是写代码，是：写代码 → 运行测试 → 读报错 → 修bug → 重新测试 → 循环直到通过。
什么时候用Agent
| 任务类型 | 适合Agent? | 怎么描述 |
|---|---|---|
| 新功能开发 | ✅ | "实现 /api/users端点，返回JSON格式用户列表，支持分页" |
| Bug修复 | ✅ | 直接把报错信息贴进Composer |
| 代码重构 | ⚠️ | 拆成小步，每步确认后再走下一步 |
| 写测试 | ✅ | "给 src/utils/math.ts 写完整单元测试" |
| 文档生成 | ✅ | "给这个项目的所有公开API写JSDoc" |
Agent使用心法
- 给验收标准："实现API端点 /api/users，要求：返回JSON、支持 page 和 limit 分页参数、写单元测试并确保通过。"——这是完美的Agent任务描述。
- Agent卡住了不要重来：给它反馈。"测试第3个用例挂了，检查空数组的边界条件"——AI在已有代码上继续修改，比重新生成效率高。
- 大工程拆成小任务："重构整个用户系统" ❌ → "重构User类型" ✅ → "更新 API 路由" ✅ → "更新前端 hook" ✅。三个小Agent > 一个大Agent迷失。
第五部分：Prompt模板 — 决定AI输出质量的天花板
代码生成黄金模板
"你是React专家。创建一个登录表单组件：邮箱和密码输入框、记住我复选框、提交按钮。TypeScript + useState管理状态，加上邮箱格式验证。只输出组件代码，不要额外解释。"
Bug修复模板
Code Review模板
代码解释模板
第六部分：.cursorrules — 用规则"训练"你的Cursor
在项目根目录创建 .cursorrules（注意前面有个点），Cursor在所有对话中都会自动参考这个文件。做不做这一步，效率差一倍。
## 技术栈
- TypeScript + React，严格模式
- Next.js 15 App Router
- Tailwind CSS，禁止内联 style
- Prisma + PostgreSQL
## 代码规范
- 组件放 src/components/，页面放 src/app/
- API调用封装在 src/services/，不要在组件里fetch
- 函数组件用 const + 箭头函数
- 命名：组件PascalCase，文件名kebab-case
- 所有异步操作必须有 loading 和 error 状态
## Git约定
- Commit遵循 Conventional Commits: feat/fix/docs/chore
- PR前确保 npm run build 通过
第七部分：快捷键速查 + 习惯建议
| 快捷键 | 功能 | 频度 | 巧记 |
|---|---|---|---|
| Ctrl+I | 打开Composer | ⭐⭐⭐⭐⭐ | I = "I need AI" |
| Ctrl+L | 内联聊天 | ⭐⭐⭐⭐⭐ | L = "Let's chat" |
| Ctrl+K | 行内编辑选中代码 | ⭐⭐⭐⭐ | K = "Korrect" |
| Tab | 接受AI补全 | ⭐⭐⭐⭐⭐ | — |
| Ctrl+Shift+I | 终端Composer | ⭐⭐⭐ | 命令行里的AI |
| Ctrl+Enter | 让AI搜索项目了解上下文 | ⭐⭐⭐⭐ | "看一遍项目再回答我" |
第八部分：常见踩坑和解决方案
坑1：Cursor索引卡顿 / CPU 100%
设置 → Features → Codebase Indexing → 添加排除目录：node_modules、.git、dist、build、.next、coverage。索引范围缩小后卡顿消失。
坑2：Agent写了一堆然后项目跑不起来
永远不要直接让Agent改核心逻辑。先让Agent在独立分支上改 → 手动review → 跑一遍项目 → 确认通过再合并。Agent的能力很强，但它不是人——它不知道你的业务逻辑有什么隐藏约束。
坑3：Composer改了不该改的文件
在Composer里明确约束："只修改 Navbar.tsx 和 theme.css，不要碰其他文件。" 加了这个约束后AI的"过度优化"行为降低90%。
坑4：Cursor和自己装的VS Code互相干扰
Cursor和VS Code完全可以并行使用——它们共享扩展和设置，不会冲突。建议：日常改代码用VS Code，需要AI帮助的复杂任务切到Cursor。这就像你日常写字用钢笔，需要复印才开复印机。
真实的效率提升路径（按照这个顺序来）
Day 3-5：学Composer → 做一个跨文件的功能 → 体验"一句话改5个文件"
Day 5-7：创建 .cursorrules → 所有@引用养成习惯 → 效率暴涨
Week 2：试Agent模式 → 选一个独立小功能让Agent自己完成 → 建立"AI能做什么"的直觉
Week 2+：两个技术线并行：写更好更具体的Prompt + 优化 .cursorrules。
一个月后：Cursor从"智能补全"变成"第二个程序员"。不是因为你用了新版本——是因为你学会了怎么用。
📝 评测更新时间：2026年6月2日