Skip to content

Cursor完全指南

Cursor是目前最受欢迎的AI代码编辑器,它将AI能力深度集成到开发工作流中,极大提升编程效率。

什么是Cursor

Cursor是一个基于VS Code的AI编辑器,具有以下特点:

  • 深度项目理解 - 能理解整个代码库的上下文
  • 多模型支持 - 支持Claude、GPT-4等多种模型
  • Composer模式 - 跨多文件同时编辑
  • AI Chat - 与AI对话讨论代码

安装与配置

下载安装

  1. 访问 cursor.sh
  2. 下载对应系统的安装包
  3. 安装完成后打开Cursor

初次配置

1. 登录/注册账号
2. 选择AI模型(推荐Claude 3.5 Sonnet)
3. 导入VS Code设置(可选)
4. 安装需要的扩展

核心功能

1. AI代码补全

在编辑器中,AI会自动建议代码:

python
def calculate_total(items):
    # 输入到这里,AI会自动补全
    # 建议:total = sum(item['price'] * item['quantity'] for item in items)
    #      return total

Tab 接受建议,按 Esc 拒绝。

2. Chat模式

快捷键 Cmd/Ctrl + L 打开聊天面板:

你:这个函数有什么问题?
AI:分析代码...发现以下问题:
    1. 没有处理空列表的情况
    2. 缺少类型提示
    ...

3. Composer模式

快捷键 Cmd/Ctrl + I 打开Composer:

你:帮我重构这个项目,把重复代码提取成公共函数

AI:我会修改以下文件:
    - src/utils.py(新增公共函数)
    - src/handlers/user.py(使用公共函数)
    - src/handlers/order.py(使用公共函数)
    
    [显示每个文件的修改内容]

4. 代码解释

选中代码,右键选择 "Explain Code":

AI会解释:
- 这段代码的作用
- 关键步骤说明
- 可能的问题点

5. 代码生成

快捷键 Cmd/Ctrl + K 在光标位置生成代码:

你:写一个函数,验证邮箱格式

AI:[直接在光标位置插入代码]
def validate_email(email: str) -> bool:
    """验证邮箱格式是否正确"""
    import re
    pattern = r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$'
    return bool(re.match(pattern, email))

常用快捷键

快捷键功能
Cmd/Ctrl + L打开AI聊天
Cmd/Ctrl + I打开Composer
Cmd/Ctrl + K生成/编辑代码
Tab接受补全建议
Cmd/Ctrl + Shift + L添加选中内容到聊天

最佳实践

1. 使用 @ 符号添加上下文

在聊天中使用 @ 引用文件或符号:

你:@src/api.py 这个函数的参数类型是什么?

2. 让AI理解项目结构

首次打开项目时:

你:请阅读这个项目的结构,理解它的架构
AI:[分析项目...]这是一个FastAPI项目,包含:
    - API路由层
    - 服务层
    - 数据访问层
    ...

3. 渐进式重构

不要一次性让AI重构所有代码:

Step 1: 先重构一个模块
Step 2: 测试验证
Step 3: 继续下一个模块

4. 利用代码库上下文

你:根据 @models/user.py 的风格,帮我写一个 Product 模型

定价(2025年)

版本价格功能
免费版$050次快速请求/月
Pro版$20/月500次快速请求 + 更多模型
Business版$40/用户/月团队管理 + 隐私模式

与GitHub Copilot对比

特性CursorGitHub Copilot
编辑器独立编辑器插件形式
项目理解深度理解有限理解
多文件编辑✅ Composer✅ Edits
模型选择多模型多模型
价格$20/月$10/月

实用技巧

技巧1:使用 .cursorrules 文件

在项目根目录创建 .cursorrules 文件:

# 项目规则
- 使用Python 3.10特性
- 遵循PEP 8规范
- 所有函数必须有类型提示
- 使用pytest写测试

AI会遵循这些规则生成代码。

技巧2:合理使用Composer

Composer适合:

  • 跨多文件修改
  • 重构任务
  • 新功能开发

单文件小改动用Chat更轻量。

技巧3:让AI写测试

你:为 @src/calculator.py 写单元测试
AI:[生成完整的测试文件]

常见问题

Q: Cursor支持中文吗?

A: 支持,可以用中文与AI交流。

Q: 如何切换模型?

A: 点击右上角的模型选择器,选择不同的模型。

Q: 代码会发送到云端吗?

A: 是的,代码会发送到AI服务器处理。使用Business版可开启隐私模式。

下一步

学会Cursor后,可以继续学习: