实操审校说明
本文属于工具实操教程。Cursor 的模型名称、免费额度、订阅价格和界面入口可能随版本变化，请以 Cursor 官方页面和客户端实际显示为准。教程重点是学习 AI 编程工作流，而不是承诺固定额度或固定效率提升。
Cursor AI 编辑器实操教程：从安装到用 AI 写出第一个项目
📅 更新时间：2026 年 6 月
👤 适合人群：完全没用过 AI 编程工具的新手、想提升开发效率的程序员
⏱ 预计操作时间：30 分钟完成环境搭建，当天就能写出第一个功能
一、Cursor 是什么？为什么现在必须学？
Cursor 是一款基于 VS Code 打造的 AI 优先代码编辑器，内置或可接入 Claude Fable 5 / Sonnet 5、GPT-5.5 等主力模型，模型列表会随 Cursor 客户端更新。
和普通编辑器的核心区别
普通写代码：
你 → 想逻辑 → 敲代码 → 查文档 → 调 Bug → 重复...
用 Cursor：
你 → 用中文描述想要什么 → Cursor 帮你写 → 你检查 → 完事数据说话
- 100 万+ 用户，36 万付费用户（2026 年）
- 据报道开发效率提升 40%~300%
- 个人免费版每月有 200 次 AI 调用额度，够用
二、下载与安装（5 分钟完成）
2.1 下载
访问官网：https://cursor.com
- Windows：下载
.exe安装包 - macOS：下载
.dmg - Linux：下载
.AppImage
像安装普通软件一样安装即可。
2.2 首次启动配置
第一次打开时会出现引导界面，按以下步骤操作：
① 导入 VS Code 设置（强烈推荐）
如果你之前用过 VS Code，选择"Import from VS Code"，主题、插件、快捷键会全部自动迁移。
② 注册账号
- 用邮箱注册，完全免费
- 无需信用卡
- 免费版：每月 200 次 AI 调用
③ 选择 AI 模型
推荐设置（在 设置 → Models 中）：
| 场景 | 推荐模型 |
| 日常写代码 | Claude Sonnet 5 / GPT-5.5（以客户端当前可选项为准） |
| 复杂逻辑 | GPT-5.5 / Claude Fable 5 或 Opus 4.8 |
| 快速补全 | 自动（由 Supermaven 驱动） |
三、界面认识（2 分钟）
打开 Cursor 后，界面和 VS Code 几乎一样，多了这几个关键区域：
┌─────────────────────────────────────────────────────┐
│ 文件浏览器（左） │ 代码编辑区（中） │ AI 面板（右） │
│ │ │ │
│ 项目文件列表 │ 你的代码在这里 │ 和 AI 对话 │
│ │ │ 在这里 │
├─────────────────┴─────────────────────────┴─────────┤
│ 终端（下方） │
└─────────────────────────────────────────────────────┘最重要的 4 个快捷键
| 快捷键 | 功能 | 使用场景 |
Ctrl/Cmd + L | 打开 AI 对话面板 | 问 AI 问题、让它写代码 |
Ctrl/Cmd + K | 内联编辑 | 选中代码后，快速修改/重构 |
Ctrl/Cmd + I | 打开 Composer | 一次修改多个文件 |
Tab | 接受 AI 代码补全 | 打代码时自动出现 |
四、核心功能实操
4.1 功能一：AI 对话（最常用）
打开方式：Ctrl/Cmd + L
实操场景：写一个爬虫函数
在 AI 对话框中输入：
用 Python 写一个函数，用 requests 爬取网页标题和正文，
返回字典格式，包含 title 和 content 两个字段，
加上异常处理，如果失败返回 NoneAI 会立即生成代码，右下角有 "Apply" 按钮，点击直接插入到你的文件中。
实操场景：解释别人的代码
选中一段看不懂的代码，Ctrl/Cmd + L，输入：
这段代码是做什么的？一步一步解释实操场景：修复 Bug
把报错信息直接粘进去：
运行时报错：TypeError: 'NoneType' object is not subscriptable
代码是：result = data['user']['name']
帮我修复4.2 功能二：内联编辑（选中即改）
使用方法：选中代码 → Ctrl/Cmd + K → 输入你想做的改变
实操练习：
- 写一个简单函数（如：
def add(a, b): return a+b） - 选中整个函数
- 按
Ctrl/Cmd + K - 输入：
给这个函数加上类型注解和 docstring - 看 AI 自动修改
常用改法：
"加上错误处理""转换成 async/await 异步写法""加上日志打印""优化性能""转成中文注释"
4.3 功能三：Tab 自动补全（最惊艳）
直接打代码，你会看到灰色的补全提示，按 Tab 接受。
Cursor 的补全不是普通的一行补全，而是多行预测：
def send_email(to, subject, body):
# 你只打了这一行注释，按 Tab...
# Cursor 会直接补全整个 smtp 发邮件代码技巧：注释越清楚，补全越准确。
4.4 功能四：Composer 多文件编辑（高效利器）
打开方式：Ctrl/Cmd + I
适用场景：需要同时修改多个文件的大功能
实操示例——给项目加用户登录功能：
在这个 Flask 项目里添加用户登录功能：
1. 创建 login.html 模板
2. 在 routes.py 里添加 /login 路由
3. 在 models.py 里添加 User 模型
4. 配置 JWT token 认证Cursor 会一次性改动所有相关文件，每个文件的改动用 diff 展示，你可以逐个接受或拒绝。
4.5 功能五：Agent 模式（最强但要谨慎）
在 Composer 里切换到 Agent 模式。
Agent 模式下，Cursor 可以：
- 自己决定要创建哪些文件
- 自己执行终端命令
- 一直工作直到任务完成
实操示例：
从零创建一个 Python 命令行工具：
- 功能：批量重命名文件夹里的图片（加日期前缀）
- 包含 argparse 命令行参数
- 支持 --preview 预览模式（不实际改名）
- 添加 README.md⚠️ Agent 模式会执行真实命令，重要项目操作前务必先 git commit 备份！
五、30 分钟实战：做一个天气查询工具
目标
做一个命令行工具，输入城市名，显示当前天气。
开始
- 新建文件夹
weather-tool，用 Cursor 打开 - 新建
main.py - 按
Ctrl/Cmd + L，输入以下 Prompt：
用 Python 写一个命令行天气查询工具：
1. 使用 wttr.in 这个免费 API（不需要 key）：
https://wttr.in/{城市名}?format=j1
2. 功能：
- 接受命令行参数：python main.py 北京
- 显示：城市名、温度、天气描述、湿度、风速
- 中文显示
3. 处理错误：网络超时、城市不存在等情况
4. 代码要简洁，加注释AI 会生成完整代码，点击 Apply。
- 在终端运行：
python main.py 北京
✅ 如果能看到天气信息，恭喜你完成了第一个 AI 辅助开发的工具！
六、高效使用技巧
写好 Prompt 的公式
【角色】你是一个 Python 专家
【任务】写一个函数
【具体要求】用 requests 库，处理 JSON，有错误处理
【格式要求】加类型注解和 docstring
【示例输入/输出】输入 url，输出 dict用 @ 引用文件
在 AI 对话框输入 @文件名，AI 会直接读取那个文件的内容，上下文更准确：
参考 @models.py 里的 User 类结构，给我写一个 Product 类常用场景 Prompt 速查
| 场景 | Prompt 模板 |
| 写新功能 | 在 @xxx.py 里加一个函数，实现 [功能描述] |
| 调 Bug | 报错信息是 [粘贴报错]，帮我分析原因并修复 |
| 代码重构 | 重构这个函数，使代码更简洁，性能更好 |
| 写测试 | 为这个函数写 pytest 单元测试，覆盖边缘情况 |
| 写文档 | 为这段代码写详细的 docstring |
七、免费 vs 付费
| 功能 | 免费版 | Pro 版（$20/月） |
| AI 对话次数 | 200 次/月 | 无限 |
| Tab 补全 | ✅ 有限 | ✅ 无限 |
| Agent 模式 | ✅ | ✅ |
| Claude Fable 5 / Opus 4.8 等高级模型 | ❌ | ✅ |
| 是否够用？ | 学习阶段够用 | 每天开发推荐 |
总结：三步上手 Cursor
- 第一天：安装 + 打开自己的旧项目，用
Ctrl+L让 AI 解释代码 - 第二天：用
Ctrl+K内联编辑，改一个真实的函数 - 第三天：用 Composer 做一个完整的小功能（比如上面的天气工具）
循序渐进，一周内就能把 Cursor 变成日常开发的核心工具。
*参考：NxCode Cursor 初学者完整指南（2026.1）| CSDN Cursor 2026 最新教程 | 51CTO Cursor 实战指南（2026.5）*
