跳转到主要内容

一、产品简介

Cursor 是一款 AI 驱动的代码编辑器,通过集成 Nebula Lab,可在编写代码时获得强大的 AI 辅助功能,支持智能代码生成、补全、解释及优化。

二、快速配置步骤

1. 打开设置

点击右上角的齿轮图标 ⚙️,选择 Models 选项。

2. 配置 API

  • OpenAI API Key:输入您的 Nebula Lab 密钥
  • Override OpenAI Base URL:勾选并输入 https://llm.ai-nebula.com/v1
  • 点击 Verify 验证配置
Cursor 目前不支持 Agent 模式,仅支持 Chat 对话模式(需手动将 AI 生成的代码应用到文件中)

3. 替代方案

若依赖 Agent 模式:
  • 购买 Cursor 官方会员
  • 使用 VS Code 的 RooCode 或 Cline 插件

三、推荐模型配置

类型推荐模型 ID特点
编程首选claude-sonnet-4-20250514Claude 4 Sonnet,编程能力最强
gpt-4.1速度快,综合能力强
deepseek-v3中文编程优秀,性价比高
成本优化gpt-4.1-mini轻量级但能力不俗
claude-3-haikuClaude 系列最便宜
gemini-2.5-flashGoogle 快速响应模型
推理增强o4-mini编程任务首选推理模型
o3适合复杂推理和算法问题

添加自定义模型

在 Cursor 设置中添加:
claude-sonnet-4-20250514
gpt-4.1
deepseek-v3
o4-mini
gemini-2.5-pro

四、使用模式说明

Chat 模式工作流程

  1. 对话生成代码Ctrl/Cmd + L 打开聊天窗口,描述需求
  2. 手动应用代码:复制代码粘贴到目标文件,或使用 “Apply” 按钮
  3. 迭代优化:继续对话要求修改

替代方案对比

工具Agent 模式优势劣势
Cursor界面优雅,补全体验好无 Agent 模式
Cline (VS Code)完整 Agent 功能需依赖 VS Code
RooCode (VS Code)支持多文件编辑较新,功能完善中
Continue (VS Code)开源,可定制性强配置较复杂

五、核心功能

智能代码补全

  • Tab 补全:按 Tab 接受 AI 建议
  • 多行补全:支持函数级别代码生成
  • 上下文感知:基于项目结构提供精准建议

AI 对话

  • Ctrl/Cmd + K:打开命令面板
  • Ctrl/Cmd + L:打开侧边栏对话
  • 代码解释:选中代码后询问 AI

代码编辑

  • 生成代码:描述需求,AI 自动生成
  • 重构建议:获取代码优化方案
  • 错误修复:AI 协助定位修复错误

六、快捷键

快捷键功能
Ctrl/Cmd + K打开 AI 命令面板
Ctrl/Cmd + L打开 AI 对话侧边栏
Tab接受代码建议
Esc取消当前建议

七、使用技巧

提供清晰的上下文

// @context: React组件,用于用户认证
// @requirements: 需要支持OAuth2登录
// @constraints: 兼容NextJS 13+

优化提示词

  • 不佳"修复这个函数"
  • 优质"修复calculateTotal函数中的浮点数精度问题,确保金额计算准确到小数点后两位"

八、故障排除

  • 检查网络连接
  • 确认 API 地址为 https://llm.ai-nebula.com/v1
  • 验证 API 密钥有效性
  • 检查账户余额
  • 尝试切换其他模型
  • 重启 Cursor 客户端
  • 提供更多项目上下文
  • 使用更具体的提示词
  • 切换性能更优的模型

九、最佳实践

项目级配置

在项目根目录创建 .cursor-settings.json
{
  "model": "gpt-4.1",
  "temperature": 0.7,
  "contextFiles": ["README.md", "package.json"],
  "rules": [
    "使用TypeScript严格模式",
    "遵循ESLint规范",
    "添加适当的注释"
  ]
}

代码审查

请审查这段代码,关注:
1. 性能问题
2. 安全漏洞
3. 代码规范
4. 最佳实践

十、关于 Agent 模式

若需要 AI 自动修改多文件、执行复杂重构任务,推荐:
  • Cline:VS Code 插件,支持完整 Agent 功能
  • RooCode:新兴 VS Code AI Agent 插件