乐于分享
好东西不私藏

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

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


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

作者:墨玄 | 发布日期:2026-05-31


一、引言:为什么 Cursor 越来越受欢迎

如果你在 2025-2026 年关注 AI 编程工具,一定绕不开 Cursor。

2025-2026 年,AI 编程工具正在改变开发者的工作方式。从硅谷大厂到国内创业公司,Cursor 就是这类工具中的佼佼者。

为什么 Cursor 越来越受欢迎?三个原因:

  1. 零学习成本:基于 VS Code,你熟悉的界面、快捷键、扩展都能继续用
  2. 多模型支持:GPT-4、Claude、Gemini…你想用的模型都有
  3. 真正的 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

  1. Agent 能力差异:Copilot 是”智能补全”,Cursor Agent 是”自主程序员”
  2. 多模型支持:Copilot 只能用 OpenAI 模型,Cursor 支持多家模型
  3. Rules 系统:Cursor 的规则系统比 Copilot 的配置更强大
  4. @Docs 功能:可以直接引用外部文档作为上下文

三、下载安装与配置

3.1 系统要求

  • macOS:macOS 12(Monterey)及更高版本
  • Windows:Windows 10 及更高版本
  • Linux:Debian/Ubuntu、RHEL/Fedora、AppImage(便携版)

3.2 macOS 安装

  1. 访问 cursor.com/downloads
  2. 下载 .dmg 安装包
  3. 双击安装,拖动到 Applications 文件夹
  4. 首次打开可能需要在”系统设置 > 隐私与安全性”中允许

命令行安装:

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)- 代码生成/编辑

功能:内联代码生成和编辑

使用方式:

  1. 选中代码或定位光标
  2. 按 Cmd+K(Mac)或 Ctrl+K(Windows/Linux)
  3. 输入指令
  4. 按 Tab 接受,或 Esc 拒绝

实操案例一:生成 debounce 函数

光标放在空白行 → Cmd+K → 输入”生成一个 TypeScript 的 debounce 函数” → Enter。Cursor 会在光标处直接插入完整的 TypeScript 泛型 debounce 函数。

实操案例二:重构现有代码

选中用 any 类型的函数 → Cmd+K → 输入”添加完整的 TypeScript 类型定义” → Enter。Cursor 会替换选中代码,生成带 interface 的类型安全版本。

4.2 Cmd+L(Ctrl+L)- 代码问答

功能:打开侧边栏聊天,进行代码问答(不修改代码)

使用方式:

  1. 按 Cmd+L(Mac)或 Ctrl+L(Windows/Linux)
  2. 在侧边栏输入问题
  3. 可附加文件(输入 @ 选择文件)

实操案例一:解释正则表达式

选中代码 → 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 文档