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 内联编辑

// 选中这段代码 → Cmd+K → 输入："加上错误处理"
// AI 会直接生成：
function fetchUser(id) {
  try {
    const user = await api.get(`/users/${id}`);
    return user;
  } catch (err) {
    console.error('Failed to fetch user:', err);
    // 上报到监控系统
    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： 
# 项目规则

- 使用 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
2. 写："@codebase 找出这个 bug 的根因"
3. 让 AI 给出修复方案
4. 用 Cmd+K 应用修复
5. 跑测试确认

四、避免的坑

❌ 不要 100% 信任 AI

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

❌ 不要让它写整个新项目

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

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

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

五、性能对比

任务不用 Cursor用 Cursor Normal用 Cursor Agent
写新组件30 分钟10 分钟5 分钟
改 Bug20 分钟8 分钟3 分钟
写测试15 分钟5 分钟2 分钟
重构60 分钟25 分钟10 分钟
结论：Cursor 不会让你失业，但不用 Cursor 的人会。

六、推荐快捷键

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

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