Cursor完全指南
Cursor是目前最受欢迎的AI代码编辑器,它将AI能力深度集成到开发工作流中,极大提升编程效率。
什么是Cursor
Cursor是一个基于VS Code的AI编辑器,具有以下特点:
- 深度项目理解 - 能理解整个代码库的上下文
- 多模型支持 - 支持Claude、GPT-4等多种模型
- Composer模式 - 跨多文件同时编辑
- AI Chat - 与AI对话讨论代码
安装与配置
下载安装
- 访问 cursor.sh
- 下载对应系统的安装包
- 安装完成后打开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年)
| 版本 | 价格 | 功能 |
|---|---|---|
| 免费版 | $0 | 50次快速请求/月 |
| Pro版 | $20/月 | 500次快速请求 + 更多模型 |
| Business版 | $40/用户/月 | 团队管理 + 隐私模式 |
与GitHub Copilot对比
| 特性 | Cursor | GitHub 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后,可以继续学习:
- GitHub Copilot教程 - 另一个主流AI编程工具
- Claude Code完全指南 - 终端AI编程助手