---

Cursor 使用教程

1. Cursor 是什么？

Cursor 是一款 AI 编程助手 + IDE，基于 VS Code 内核开发，内置了 ChatGPT/GPT 模型。它能结合上下文（包括你当前打开的代码）直接帮你写代码、改代码、解释代码，甚至生成文档，快速让你的代码产生商业价值。

它的特点：

• 无缝替代 VS Code（插件体系和大多数快捷键兼容）。
• 内置 AI Copilot（类似 GitHub Copilot，但功能更强大）。
• 支持代码自动补全、解释、重构、测试生成。
• 通过命令面板（⌘K / Ctrl+K）快速调用 AI。

---

2. 安装与环境准备

1. 打开官网 https://cursor.sh 下载对应系统版本（macOS、Windows、Linux）。
2. 安装完成后启动，使用 GitHub 或 Google 账号登录。
3. （可选）在设置中配置自己的 OpenAI API Key，这样可以使用最新模型。

---

3. 基础使用

3.1 打开和管理项目

• File -> Open Folder 打开项目文件夹。
• 支持 Git 仓库，可以直接在终端里执行 git clone 然后在 Cursor 中打开。

3.2 AI 聊天区

• 左侧有一个 Chat 面板，可以和 AI 对话。
• 你可以粘贴代码，让它帮你解释或修改。
• AI 回答时会自动识别你项目里的文件结构。

3.3 AI 命令面板

按下快捷键：

• Mac：⌘K
• Windows/Linux：Ctrl+K

常用功能：

• Explain Code：解释选中代码。
• Fix Errors：修复报错。
• Refactor：重构。
• Write Tests：为代码写单元测试。
• Generate Docstring：生成注释。

---

4. 实用功能示例

4.1 代码解释

选中一段函数 → ⌘K → Explain → AI 会生成解释。

4.2 自动补全

在写代码时，AI 会自动提示下一行/下一段。
按 Tab 接受建议，Esc 取消。

4.3 重构和优化

选中函数 → ⌘K → Refactor → 自动生成优化后的代码。

4.4 测试生成

选中类或函数 → ⌘K → Write Tests → 自动生成对应的测试代码。

4.5 多文件上下文

在 Chat 里输入问题时，AI 会结合整个项目文件夹，而不是只看一个文件。

---

5. 进阶技巧

1. 代码比较
   AI 修改后，Cursor 会展示 diff 视图，你可以选择 Accept 或 Reject。

2. 多语言支持
   支持 Java、Python、Go、C++、JS/TS 等常见语言。

3. Prompt 工程
   你可以在 Chat 里写更明确的指令，例如：

   “请为这个类生成一个使用 JUnit 的单元测试，覆盖 95% 的分支。”

4. 团队协作
   配合 Git 使用，可以让 AI 自动生成 commit message，甚至 PR 描述。

---

6. 常用快捷键

• ⌘K / Ctrl+K → 打开 AI 命令面板。
• ⌘Enter / Ctrl+Enter → 将选中的代码发送给 AI。
• Tab → 接受补全。
• Esc → 取消补全。

---

7. 与 VS Code 的区别

功能	VS Code	Cursor
插件市场	✅	✅（兼容大部分）
AI 辅助编程	需要 GitHub Copilot	内置更强大的 AI
上下文感知	一般	项目级别上下文
命令面板 AI	❌	✅
代码对比（Diff）	手动 Git	自动集成 AI 修改

---

8. 建议使用场景

• 快速理解别人代码（Explain）。
• 写新模块时快速生成模板。
• 老代码重构和优化。
• 自动生成测试用例。
• 多语言项目（AI 可以帮助在不同语言间迁移）。

---