Cursor 入门指北

## **第一步：安装与配置**

1. **下载安装**

 • 官网 [cursor.so](https://cursor.so/) 下载对应系统版本（Win/macOS/Linux）

 • 首次启动需注册账号（支持 GitHub/Google 登录）

2. **界面汉化**

 输入 `>language` 选择 **中文**，按 `Ctrl+S` 保存设置

3. **模型选择**

 • 右上角「设置 AI Model」切换模型：

   ◦ `GPT-4`：复杂逻辑处理

   ◦ `Claude 3`：快速代码生成

   ◦ `o1-mini`：本地轻量模型（无限次使用）

---

### **核心界面解析**

| 区域 | 功能说明 | 快捷键 |

|-------------|---------------------------------|------------------|

| **侧边栏** | 项目管理、Git 操作、AI 对话历史 | `Ctrl+B` 切换显示 |

| **编辑区** | 代码编写 + AI 补全（实时提示） | `Tab` 接受建议 |

| **聊天面板** | 输入自然语言指令与 AI 协作 | `Ctrl+L` 快速呼出 |

---

### **新手必学 5 大功能**

#### 1. **智能代码补全**

 • 输入时自动显示灰色预测代码，按 `Tab` 接受建议

 • *示例：输入 `function calculate` 自动补全完整函数*

#### 2. **代码生成指令**

 选中代码 按 `Ctrl+K` 输入需求：

 ```bash

 # 示例指令

 "将这段代码转成 Python 类"

 "添加错误处理逻辑"

 "优化时间复杂度"

 ```

#### 3. **跨文件协作**

 在聊天框输入 `/` 触发高级指令：

 • `/edit file.py` 直接修改指定文件

 • `/compare A.js vs B.js` 对比代码差异

#### 4. **调试助手**

 运行代码报错时：

 1. 按 `F5` 启动调试

 2. 点击错误信息 自动分析问题原因

 3. 输入 `@error` 获取修复建议

#### 5. **文档查询**

 在聊天框输入：

 ```bash

 @react 如何实现状态共享？

 @python 解释装饰器用法

 ```

 AI 会结合官方文档生成解释 + 代码示例

---

### **个性化设置建议**

1. **主题定制**

 输入 `>theme` 选择暗色/亮色主题，或自定义配色方案

2. **快捷键优化**

 在 `settings.json` 中添加：

 ```json

 {

   "keybindings": {

     "acceptSuggestion": "Ctrl+Enter", // 修改补全快捷键

     "openChat": "Alt+C"

   }

 }

 ```

3. **项目级规则**

 创建 `.cursor/config.json` 定义 AI 行为：

 ```json

 {

   "rules": {

     "noAny": true, // 禁止使用any类型

     "functionComment": true // 强制函数注释

   }

 }

 ```

---

### **常见问题解决**

| 问题现象 | 解决方案 |

|-----------------------|---------------------------------|

| 代码补全不显示 | 检查网络连接 重启软件 输入 `>reset` |

| 中文指令识别错误 | 在指令前加 `[zh]` 强制中文模式 |

| 模型调用次数耗尽 | 切换至 o1-mini 模型继续使用 |

| 快捷键冲突 | 设置 Keybindings 重置默认 |

---

### **效率提升技巧**

1. **语音输入指令**

 按 `Ctrl+Shift+V` 启动语音输入（支持中文）

2. **历史记录复用**

 聊天面板点击「时钟」图标复用过往指令

3. **模板项目生成**

 输入 `/create` 选择预设模板（Web/App/CLI）

---

**提示**：免费版每月可调用 GPT-4/Claude 3 各 50 次，建议将关键任务分配给高级模型，常规任务使用 o1-mini。遇到问题可输入 `>help` 调出官方文档。