Cursor 教程：https://www.runoob.com/cursor/cursor-intro.html

Cursor 使用教程（详尽版）

适用于初次接触 Cursor 的开发者，涵盖安装、界面、提示工程、代码协作、常见问题与最佳实践。请根据需要跳转阅读。

1. Cursor 是什么

• 基于 VS Code 内核的 AI 开发工具，内置 Chat、Agent、代码补全、代码搜索与终端自动化。
• 支持本地与云模型（OpenAI、Anthropic、Azure、Ollama 等），可在设置中自由切换。

2. 安装与基础配置

• 下载：访问 https://cursor.sh%EF%BC%8C%E6%A0%B9%E6%8D%AE%E6%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F%E4%B8%8B%E8%BD%BD%E5%AE%89%E8%A3%85%E5%8C%85%E3%80%82
• 登录：首次启动可使用 GitHub/Google/Microsoft 账号登录；若使用自建 API Key，可在设置中直接填写。
• 模型配置：Settings > Models 选择默认模型，或为聊天/补全/命令分配不同模型；可填写自定义 API Key。
• 代理/网络：在 Settings > Network 配置 HTTP(S) 代理，确保模型可访问。
• 同步设置：登录同一账号可同步偏好与快捷键。

3. 界面速览

• 左侧资源区：文件树、搜索、Git、调试等面板与 VS Code 基本一致。
• 右上角 AI 入口：Chat 面板、Composer（改写/生成）、Slash Commands（/fix、/doc 等）。
• 编辑区：与 VS Code 相同，支持多标签；AI 提示与内联补全会在编辑区出现。
• 底部：终端、问题（Problems）、输出（Output），可与 AI 结合执行命令。

4. 基础使用流程

1. 选择模型并确认 API Key 可用。
2. 在 Chat 面板输入需求（可 @ 文件/选区）；或直接在代码中选中片段，按 Cmd/Ctrl+L 打开 Chat 带上下文。
3. 查看 AI 回答，使用 Apply/Insert 将建议写回文件；必要时先在 Diff 视图审查。
4. 运行测试/终端命令验证；出现错误可用 /fix 让 AI 诊断并生成补丁。

5. 提示与上下文技巧

• 精确指令：描述目标、约束（语言、风格、性能）、输入输出示例。
• 引用上下文：
  • 选中文件片段后按 Cmd/Ctrl+L；或在 Chat 中输入 @文件名/@符号/@选区 让 AI 聚焦。
  • 使用 @terminal 引用最近的终端输出，便于调试。
• 控制修改范围：要求“仅修改 X 文件”“保留现有接口”“给出补丁 diff”。
• 迭代：让 AI 先给计划，再逐步执行，避免一次性大改。

6. 代码补全与重写

• 内联补全：输入时自动提示，Tab 接受，Esc 取消。
• 多光标/块级改写：选中文本后使用命令面板 Cmd/Ctrl+Shift+P 输入 Cursor: Ask 或 Cursor: Edit，让 AI 改写选区。
• Composer：右键选区选择 Improve/Generate Tests 等模板化操作。

7. 常用 Slash Commands（Chat 内输入）

• /fix：根据报错信息生成修复建议。
• /doc：为代码生成注释或文档。
• /test：生成或补全测试。
• /optimize：给出性能/复杂度优化建议。
• /review：对改动做代码评审提示。

8. 终端与命令协作

• 在 Chat 中描述命令意图，让 AI 生成命令，确认后可直接执行。
• @terminal 提供最近终端输出给 AI，便于错误定位。
• 复杂命令前先让 AI 解释风险，再决定是否执行。

9. Git 工作流建议

• 让 AI 总结改动：/review 或“总结当前 diff 变化点”。
• 生成提交信息：粘贴 git diff 或使用 @terminal 引用 git status/git diff 输出。
• 保持小步提交：引导 AI 生成分阶段补丁，避免一次性大改动。

10. 调试与测试

• 将错误栈粘贴到 Chat，附上相关代码 @文件，使用 /fix 获取修复方案。
• 让 AI 生成/补全单元测试、端到端测试脚本，并解释覆盖范围。
• 当回答不准时，减少上下文干扰：仅提供最小可复现片段。

11. 提升回答质量的实用套路

• 明确“当前状态”与“目标状态”，要求给出步骤或补丁。
• 要求回答格式：如“给出三条方案+优缺点”“仅输出可运行命令”。
• 对大型文件：要求“先列出受影响的函数”，再让 AI 针对具体函数处理。
• 对生成代码：要求“使用纯 ASCII”“遵循现有 lint/format 规则”。

12. 常见问题排查

• 无法联网/超时：检查代理、API Key 配额、模型可用性。
• 补全质量差：切换模型、提供更清晰的函数签名或类型定义。
• 上下文错误：确认引用的文件/选区是否正确；减少无关输入。
• 提交前审查：使用 Diff 视图核对 AI 修改，避免误改无关文件。

13. 高阶用法

• 自定义系统提示：在 Chat 设置里固定项目规范（编码规范、架构约束）。
• 多模型策略：聊天用强模型，补全用快模型，命令/改写用稳健模型。
• 本地模型：配置 Ollama/LM Studio 端点以离线使用，注意上下文窗口限制。
• 片段搜索：结合文件树搜索与全局搜索，提示 AI 精确定位函数/类型。

14. 快捷键备忘（默认，可在设置中自定义）

• 打开 Chat：Cmd/Ctrl+L
• 接受补全：Tab，取消：Esc
• 命令面板：Cmd/Ctrl+Shift+P
• 选区改写（Cursor: Ask/Edit）：Cmd/Ctrl+Shift+L
• 打开终端：`Ctrl+``
• Diff 审查：使用 Apply 前先 View Diff

15. 最佳实践清单

• 小步对话：先要计划，再要补丁，再要测试建议。
• 明确范围：告诉 AI 哪些文件可以改，哪些不能动。
• 及时验证：每轮改动后跑测试或关键命令。
• 保持上下文干净：只提供相关文件/日志，避免冗余信息稀释答案。
• 养成审查习惯：Diff 视图确认再写入，必要时让 AI 自审（/review）。

16. 学习路径建议

1. 先用 Chat 生成/改写小函数，熟悉上下文引用。
2. 练习 /fix 处理真实报错，体验终端协作。
3. 让 AI 写测试与提交信息，形成闭环工作流。
4. 对项目设定系统提示，固化团队编码规范。

17. 参考与支持

• 官方站点：https://cursor.sh
• 文档与更新日志：在应用内 Settings > About 查看。
• 社区讨论：Cursor Discord、GitHub Issues。
• 常用模型指南：根据项目大小与预算选择合适的上下文窗口和速率。