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

我用 Cursor 写了 6 个月的生产代码，效率提升保守估计 3 倍。本文是我所有踩坑和最佳实践的总结。

一、安装与配置

1.1 下载安装

前往 cursor.sh 下载对应平台版本。

1.2 关键设置

  • Cursor Settings > Models：推荐 claude-3.5-sonnet 或 gpt-4o
  • Cursor Settings > Features > Cursor Tab：开启行内补全
  • 隐私设置：敏感项目关闭 Privacy Mode

二、核心功能

2.1 Cmd+K 内联编辑

class=class="hl-string">"hl-comment">// 选中这段代码 → Cmd+K → 输入："加上错误处理"
class=class="hl-string">"hl-comment">// AI 会直接生成：
function fetchUser(id) {
  try {
    const user = await api.get(`/users/${id}`);
    return user;
  } catch (err) {
    console.error('Failed to fetch user:', err);
    class=class="hl-string">"hl-comment">// 上报到监控系统
    Sentry.captureException(err);
    throw new UserFetchError(id, err);
  }
}

2.2 Cmd+L 对话面板

最强大的功能。常用模式：

| 模式 | 用法 | |---|---| | @codebase | 让 AI 理解整个项目再回答 | | @file | 针对单个文件提问 | | @web | 让 AI 联网查文档 | | @doc | 上传 PDF / 图片 |

2.3 Composer（多文件编辑）

按 Cmd+I 打开 Composer，一次性改多个文件。适合：
  • 新建一个完整功能模块
  • 重构跨文件接口
  • 批量改名

三、实战技巧

3.1 写好规则文件

在项目根目录创建 .cursorrules：

\\\`markdown

项目规则

  • 使用 TypeScript strict 模式
  • React 组件用函数式 + Hooks
  • API 调用全部在 /lib/api 目录
  • 错误处理必须包含 user-friendly 提示
  • 提交前必须跑 pnpm test
\\\`

3.2 Agent 模式

Composer 顶部选 Agent 而非 Normal：
  • Agent 会自动跑命令、读文件、写文件
  • 适合"实现 X 功能"这种开放任务
  • 完成后会总结改了什么

3.3 调试 Bug

最高效的 Cursor 用法：

\\\`

  1. 把报错信息粘贴到 Cmd+L
  1. 写："@codebase 找出这个 bug 的根因"
  1. 让 AI 给出修复方案
  1. 用 Cmd+K 应用修复
  1. 跑测试确认
\\\`

四、避免的坑

❌ 不要 100% 信任 AI

AI 写的代码要 review，特别是：
  • 安全相关（认证、SQL、密码）
  • 性能关键路径
  • 边界条件

❌ 不要让它写整个新项目

没有 codebase 上下文，AI 会写出脱离实际架构的代码。先有 30% 代码，再让 AI 补 70%。

❌ 不要在对话里贴敏感数据

即使开了 Privacy Mode，任何发给云端的内容都有泄漏风险。

五、性能对比

| 任务 | 不用 Cursor | 用 Cursor Normal | 用 Cursor Agent | |---|---|---|---| | 写新组件 | 30 分钟 | 10 分钟 | 5 分钟 | | 改 Bug | 20 分钟 | 8 分钟 | 3 分钟 | | 写测试 | 15 分钟 | 5 分钟 | 2 分钟 | | 重构 | 60 分钟 | 25 分钟 | 10 分钟 |

结论：Cursor 不会让你失业，但不用 Cursor 的人会。

六、推荐快捷键

| 快捷键 | 功能 | |---|---| | Cmd+K | 内联编辑选中代码 | | Cmd+L | 打开对话面板 | | Cmd+I | Composer（多文件编辑） | | Cmd+Shift+K | 查看上次对话历史 | | Tab | 接受行内补全 | | Cmd+Z | 撤销 AI 修改 |

掌握这些，一天的工作量从 8 小时缩短到 4 小时。