Cursor 使用手册

以下是 Cursor 编辑器中文使用手册的详细指南，综合了多个权威来源的核心信息，帮助用户快速掌握这款 AI 驱动代码编辑器的核心功能与操作技巧：

---

一、Cursor 简介

Cursor 是一款基于 Visual Studio Code (VS Code) 核心开发的独立代码编辑器，深度集成了 GPT-4、Claude 3.5 等先进的大型语言模型（LLM），提供智能代码补全、自然语言编程、跨文件编辑等功能，显著提升开发效率。

核心优势：

• AI 深度集成：无需额外插件，直接通过自然语言与代码交互。
• 类 VS Code 界面：支持导入 VS Code 配置，无缝切换使用习惯。
• 多模型支持：免费用户可调用 GPT-4 和 Claude 3.5（每月 500 次），付费 Pro 订阅无限制。

---

二、安装与配置

1. 下载与安装

• 官网下载：访问 Cursor 官网，选择对应操作系统（Windows/macOS/Linux）安装包。
• 注册账号：支持 Google、GitHub 或邮箱注册，新用户可享 两周 Pro 试用。

2. 设置中文

• 打开命令面板（Ctrl/Cmd + Shift + P），输入 >language，选择 Configure Display Language，切换为“简体中文”。

3. 模型选择

• 在右上角设置中切换 AI 模型（如 GPT-4、Claude 3.5 或 o1-mini），不同模型在代码生成速度和准确性上有所差异。

---

三、核心功能与快捷键

1. AI 代码补全

• 自动补全：输入代码时按 Tab 接受建议，Esc 拒绝建议。
• 内联编辑（Cmd/Ctrl + K）：
  • 选择代码后触发，通过自然语言描述修改需求（如“将函数改为异步”）。
  • 支持多行编辑与差异对比（高亮显示修改部分）。

2. 聊天与上下文交互

• 打开聊天（Cmd/Ctrl + L）：提问如“这段代码有错误吗？”，AI 会根据当前文件内容回答。
• @ 符号注入上下文：
  • @文件名：引用文件内容（如 @utils.js）。
  • @Web：联网搜索最新信息（如“@Web 如何用 Python 发送 HTTP 请求”）。

3. 代码生成与重构

• 从零生成代码：在空白处按 Cmd/Ctrl + K，输入需求（如“创建 React 计数器组件”）。
• 多文件编辑（Cmd/Ctrl + I）：在 Composer 模式下跨文件修改代码，支持批量重构。

---

四、高级功能与技巧

1. 代码库索引（Codebase Indexing）

• 开启后，Cursor 通过向量相似度检索（Vector Similarity Search）理解整个项目结构，提升代码建议的准确性。

2. 自动修复与调试

• Fix Lints：悬停代码错误提示，点击“Fix”自动修复（支持 TypeScript、Rust 等语言）。
• Auto-Debug：终端报错后点击“Auto-Debug”，AI 生成解决方案。

3. 自定义 AI 规则

• 在 System Prompt 中设置角色指令（如“你是一名资深全栈工程师”），指导 AI 生成符合需求的代码。

---

五、常见问题解决

1. 账号限制问题

• “Too many free trial accounts”：
  • 删除机器 ID 文件：~/Library/Application Support/Cursor/machineid（macOS）或对应路径文件。
  • 使用插件 cursor-fake-machine 绕过限制。

2. 代码生成质量优化

• 通过 @Code 或 @Definitions 注入精准代码片段，提升上下文相关性。

---

六、资源推荐

• 官方文档：Cursor 官方指南

---

通过以上指南，您可以快速掌握 Cursor 的核心功能。如需进一步探索，建议结合官方文档与实际项目实践，充分利用 AI 提升编码效率。