Cursor AI 编辑器全面教程:从入门到实战

Cursor AI 编辑器全面教程:从入门到实战
作者:墨玄 | 发布日期:2026-05-31
一、引言:为什么 Cursor 越来越受欢迎
如果你在 2025-2026 年关注 AI 编程工具,一定绕不开 Cursor。
2025-2026 年,AI 编程工具正在改变开发者的工作方式。从硅谷大厂到国内创业公司,Cursor 就是这类工具中的佼佼者。
为什么 Cursor 越来越受欢迎?三个原因:
- 零学习成本:基于 VS Code,你熟悉的界面、快捷键、扩展都能继续用
- 多模型支持:GPT-4、Claude、Gemini…你想用的模型都有
- 真正的 Agent 能力:不只是补全,它能自主完成整个任务
最重要的是:Cursor 是 IDE,不是 CLI。你不需要学习新的工具,它就在你每天用的编辑器里。
二、Cursor 是什么
2.1 产品定位
Cursor 是基于 VS Code 的AI 原生 IDE。它不是 VS Code 的扩展,而是 VS Code 的一个分支(fork),在核心层面深度集成了 AI 功能。
这意味着:
- 你所有熟悉的 VS Code 功能都保留
- 你安装的 VS Code 扩展都能继续用
- 你的配置、快捷键、代码片段都能直接迁移
2.2 与 VS Code 的关系
VS Code:
- 微软开发
- AI 功能需要 Copilot 扩展
- 完整的扩展生态
Cursor:
- VS Code 分支
- AI 功能原生深度集成
- 一键导入 VS Code 配置
- 内置 Agent 模式
- 支持多家模型(OpenAI、Anthropic、Google、xAI)
简单来说:Cursor = VS Code + 深度集成的 AI Agent
2.3 为什么选择 Cursor 而不是 VS Code + Copilot
- Agent 能力差异:Copilot 是”智能补全”,Cursor Agent 是”自主程序员”
- 多模型支持:Copilot 只能用 OpenAI 模型,Cursor 支持多家模型
- Rules 系统:Cursor 的规则系统比 Copilot 的配置更强大
- @Docs 功能:可以直接引用外部文档作为上下文
三、下载安装与配置
3.1 系统要求
- macOS:macOS 12(Monterey)及更高版本
- Windows:Windows 10 及更高版本
- Linux:Debian/Ubuntu、RHEL/Fedora、AppImage(便携版)
3.2 macOS 安装
- 访问 cursor.com/downloads
- 下载 .dmg 安装包
- 双击安装,拖动到 Applications 文件夹
- 首次打开可能需要在”系统设置 > 隐私与安全性”中允许
命令行安装:
curl https://cursor.com/install -fsS | bash
3.3 Windows 安装
访问 cursor.com/downloads 下载 .exe 安装程序,按提示完成安装。
3.4 Linux 安装
Debian/Ubuntu(推荐):
# 添加 Cursor 的 GPG 密钥
curl -fsSL https://downloads.cursor.com/keys/anysphere.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/cursor.gpg > /dev/null
# 添加 Cursor 仓库
echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/cursor.gpg] https://downloads.cursor.com/aptrepo stable main" | sudo tee /etc/apt/sources.list.d/cursor.list > /dev/null
# 更新并安装
sudo apt update
sudo apt install cursor
3.5 VS Code 配置迁移
Cursor 首次启动时会自动检测 VS Code,并提示导入配置。自动迁移包括:设置、键盘快捷键、扩展、代码片段。
3.6 首次启动:配置迁移向导
安装完成后首次打开 Cursor,会看到”Import from VS Code”按钮。点击后可以选择要迁移的内容(Settings、Shortcuts、Extensions、Snippets 等),导入完成后会提示重启应用设置。
3.7 首次打开项目的完整步骤
配置迁移完成后,打开项目文件夹有三种方式:
- 方式一:点击欢迎页的”Open Folder”按钮
- 方式二:在终端中运行
cursor . - 方式三:使用快捷键 Cmd+O(Mac)或 Ctrl+O(Windows/Linux)
首次打开项目后,需要信任工作区(点击”Yes, I trust the authors”),等待项目初始化完成即可开始编码。
可选步骤:配置项目级规则
在项目根目录创建 .cursorrules 文件,写入编码规范,Cursor 的 AI 会在每次生成代码时自动参考这个文件。
四、三大核心快捷键实操
Cursor 有三个核心快捷键,掌握它们是高效使用的关键。
4.1 Cmd+K(Ctrl+K)- 代码生成/编辑
功能:内联代码生成和编辑
使用方式:
- 选中代码或定位光标
- 按 Cmd+K(Mac)或 Ctrl+K(Windows/Linux)
- 输入指令
- 按 Tab 接受,或 Esc 拒绝
实操案例一:生成 debounce 函数
光标放在空白行 → Cmd+K → 输入”生成一个 TypeScript 的 debounce 函数” → Enter。Cursor 会在光标处直接插入完整的 TypeScript 泛型 debounce 函数。
实操案例二:重构现有代码
选中用 any 类型的函数 → Cmd+K → 输入”添加完整的 TypeScript 类型定义” → Enter。Cursor 会替换选中代码,生成带 interface 的类型安全版本。
4.2 Cmd+L(Ctrl+L)- 代码问答
功能:打开侧边栏聊天,进行代码问答(不修改代码)
使用方式:
- 按 Cmd+L(Mac)或 Ctrl+L(Windows/Linux)
- 在侧边栏输入问题
- 可附加文件(输入 @ 选择文件)
实操案例一:解释正则表达式
选中代码 → Cmd+L → 代码自动附加到聊天框 → 输入”解释这个正则表达式” → Enter。Cursor 会逐部分解释正则表达式的含义。
实操案例二:跨文件问答
使用 @Codebase 功能,让 Cursor 搜索整个代码库,理解多文件模块的工作流程。
4.3 Cmd+I(Ctrl+I)- 项目级开发(Agent)
功能:打开 Agent 模式,进行项目级自主开发
这是 Cursor 最强大的功能。
Agent 能力:
- 🔍 搜索和理解代码库
- 📄 读取和编辑多个文件
- ⚡ 运行终端命令
- 🌐 使用浏览器测试应用
Plan Mode(计划模式):对于复杂任务,按 Shift+Tab 切换到 Plan Mode,Agent 会先研究代码库并创建详细实施计划,等待你批准后再执行。
实操案例:从零搭建 RESTful API 项目
Cmd+I → Shift+Tab(Plan Mode)→ 输入任务描述 → Enter → Agent 生成实施计划 → 批准执行 → Agent 自动创建所有文件并验证。
4.4 其他重要快捷键
- Tab:自动补全代码
- Cmd/Ctrl + Shift + P:命令面板
- Cmd/Ctrl + Shift + L:选择所有匹配
- Cmd/Ctrl + D:选择下一个匹配
Cursor 核心快捷键一览
五、多模型切换体验
5.1 支持的模型
Cursor 支持多家前沿 AI 模型:
- OpenAI:GPT-4o、GPT-4、o1-preview、o1-mini
- Anthropic:Claude 3.5 Sonnet、Claude 3 Opus、Claude 3 Haiku
- Google:Gemini Pro、Gemini Ultra
- xAI:Grok
- Cursor 自有模型:Cursor-fast、Cursor-small
5.2 模型切换方式
在聊天输入框顶部点击模型选择器,或按 Cmd/Ctrl + / 循环切换。
5.3 模型选择建议
- 快速编辑、简单任务:Cursor-fast、Claude 3 Haiku(速度快)
- 复杂推理、多文件重构:Claude 3.5 Sonnet、GPT-4o(推理能力强)
我的推荐:日常编码默认使用 Claude 3.5 Sonnet,代码质量高;简单任务切换到 Cursor-fast 或 Claude 3 Haiku,节省配额。
六、高级功能
6.1 Rules 系统
通俗解释:Rules 就像是给 AI 写”工作手册”,告诉它应该遵循什么编码规范、用什么技术栈。
在项目根目录创建 .cursor/rules 文件夹,放置规则文件:
.cursor/rules/
react-patterns.md # React 组件规范
api-guidelines.md # API 开发指南
创建规则的方法:在 Agent 聊天中输入 /create-rule,描述想要的规则,Agent 会自动生成规则文件。
6.2 @Docs 功能
@Docs 让 Cursor 可以引用外部文档作为上下文。在聊天输入框输入 @ 选择 Docs,搜索或添加新文档。
6.3 MCP 集成
Cursor 也支持 MCP(Model Context Protocol),可以连接外部工具和数据源。
6.4 Checkpoints(检查点)
Checkpoints 是独立于 Git 的版本快照功能,自动保存代码快照,可随时回滚到之前状态。
七、免费额度与定价说明
- Hobby 免费版:无需信用卡,有限次数的 Agent 请求和 Tab 补全,适合初次体验和轻度使用
- Pro 版($20/月):更多 Agent 请求次数,访问前沿模型,MCP 支持,Cloud agents,适合个人开发者和重度用户
- Teams 版($40/用户/月):集中团队计费,团队市场,团队级隐私模式,SAML/OIDC SSO,适合 3-10 人开发团队
八、适用场景总结
8.1 Cursor 最适合
- ✅ VS Code 用户(零学习成本)
- ✅ 需要多模型切换
- ✅ 需要完整 IDE 功能
- ✅ 团队协作开发
- ✅ 需要图形界面
8.2 Claude Code 最适合
- ✅ 终端重度用户
- ✅ 需要强大子代理架构
- ✅ 需要沙箱模式
- ✅ 自动化工作流
8.3 同时使用两者
Cursor 用于日常编码和调试,Claude Code 用于复杂的多文件重构和自动化任务。
九、总结
Cursor 是目前最成熟的 AI 编程 IDE 之一,它成功地将 AI 能力深度集成到开发者熟悉的编辑器中。
核心优势:
- 🎯 零学习成本:基于 VS Code,无缝迁移
- 🤖 真正的 Agent 能力:不只是补全,能自主完成任务
- 🔄 多模型支持:OpenAI、Anthropic、Google、xAI…随需切换
- 📚 Rules 系统:强大的规则定制能力
三大快捷键,掌握即可上手:
- Cmd+K:内联代码生成/编辑
- Cmd+L:代码问答(不修改代码)
- Cmd+I:Agent 模式(自主开发)
适用人群:
- VS Code 用户(零学习成本)
- 需要多模型切换的开发者
- 需要完整 IDE 功能的团队
需要注意:
- 免费版功能有限
- Pro 版 $20/月
如果你正在寻找一个能真正帮你写代码、改代码、跑测试的 AI IDE,Cursor 是目前最值得尝试的选择之一。
本文由墨玄创作,如有问题欢迎在评论区讨论。
相关链接:Cursor 官网 | Cursor 下载 | Cursor 文档
夜雨聆风