Cursor

Overview

Cursor 是一个内置 AI 能力的代码编辑器，基于 VS Code 构建，提供了深度集成的 AI 编程体验。它不仅仅是简单的代码补全工具，而是能够理解整个代码库、进行复杂推理、编写和修改代码的智能助手。

Cursor 的核心优势在于其无缝的 AI 集成：AI 能力不是作为一个独立功能存在，而是融入到编辑器的每一个环节——代码补全、聊天对话、代码搜索、重构建议、测试生成等。这使得开发者可以在不中断工作流的情况下获得 AI 辅助。

Features

• 智能代码补全：基于上下文的多行代码补全
• AI 聊天：内置聊天界面，可询问任何问题
• 代码库理解：深度理解整个项目结构和代码关系
• 代码搜索：自然语言搜索代码
• 自动重构：根据描述自动重构代码
• 测试生成：自动生成单元测试
• 错误修复：分析错误信息并提供修复建议
• 多模型支持：支持 Claude、GPT-4 等多种模型

Installation

# macOS
brew install --cask cursor

# Windows
# 从官网下载安装程序
https://cursor.sh

# 启动 Cursor
cursor

Quick Start

1. 下载并安装 Cursor
2. 打开或创建一个项目
3. 使用快捷键 Cmd+K (Mac) 或 Ctrl+K (Windows) 调用 AI
4. 输入你的需求，如"添加用户认证功能"
5. AI 会生成代码并自动应用到文件中

Core Concepts

编辑模式

Cursor 提供多种 AI 交互模式：

模式	快捷键	用途
行内编辑	Cmd+K / Ctrl+K	直接编辑当前代码
聊天	Cmd+L / Ctrl+L	与 AI 对话
代码搜索	Cmd+Shift+F	搜索代码库
代码生成	Cmd+I / Ctrl+I	生成新代码

上下文感知

Cursor 的智能之处在于其上下文感知能力：

• 当前文件：自动包含当前打开的文件
• 相关引用：自动包含被引用或引用的代码
• 项目结构：理解整个项目的目录结构
• Git 历史：可选包含最近的提交历史
• 错误信息：自动捕获终端错误

Examples

示例 1：添加新功能

在编辑器中按 Cmd+K，输入：

"添加一个用户注册 API 端点，包含邮箱验证和密码加密"

Cursor 会：
1. 分析现有项目结构
2. 生成路由、控制器、模型代码
3. 自动应用到相应文件
4. 提供预览和接受/拒绝选项

示例 2：调试错误

终端出现错误：
TypeError: Cannot read property 'map' of undefined

在聊天中粘贴错误信息：

"为什么会出现这个错误？如何修复？"

Cursor 会：
1. 分析错误堆栈
2. 定位到问题代码
3. 解释错误原因
4. 提供修复建议

示例 3：代码重构

选中一段代码，按 Cmd+K，输入：

"重构这段代码，使用函数式编程风格，添加类型注解"

Cursor 会：
1. 分析当前代码逻辑
2. 生成重构后的代码
3. 保持原有功能不变
4. 应用重构并显示 diff

Pros

• ✅ 基于 VS Code，熟悉的界面和操作
• ✅ AI 深度集成到编辑器每个环节
• ✅ 强大的代码库理解能力
• ✅ 支持多种 LLM 模型
• ✅ 免费版本功能丰富
• ✅ 活跃的社区和频繁更新

Cons

• ❌ 高级功能需要付费订阅
• ❌ 基于 VS Code，某些 VS Code 插件可能不兼容
• ❌ 对大型代码库的索引需要时间
• ❌ 隐私考虑（代码需要发送到云端）

Use Cases

Use Case	Why Cursor
Daily Development	Seamless AI integration into your existing workflow
Large Codebase Navigation	Deep understanding of project structure
Rapid Prototyping	Generate and apply code instantly
Debugging Complex Issues	AI analyzes errors and suggests fixes
Learning New Codebases	AI explains code and architecture

Comparison with Alternatives

Feature	Cursor	Aider	Claude Code	VS Code + Copilot
Paradigm	IDE-integrated	CLI pairing	Methodology-driven	IDE plugin
Context Awareness	✅ Deep	✅ Good	✅ Good	⚠️ Limited
Multi-file Edit	✅ Yes	✅ Yes	✅ Yes	⚠️ Limited
Self-hostable	❌ No	✅ Yes	✅ Yes	❌ No
Free Tier	✅ Generous	✅ Free	✅ Free	⚠️ Limited
Learning Curve	Low	Low	Medium	Low
Best for	Daily coding	CLI users	Structured work	Quick suggestions

Best Practices

1. Use Cmd+K for inline edits — Fastest way to modify code
2. Use Cmd+L for chat — Ask questions about your codebase
3. Be specific in prompts — Include file paths and context
4. Review before accepting — Always check generated code
5. Use @ symbols to reference files — Include relevant context
6. Leverage codebase search — Use natural language to find code

Troubleshooting

Issue	Solution
Slow indexing	Wait for initial index to complete; check disk space
Context too large	Use @ to select specific files instead of full codebase
Model rate limits	Switch models in settings or use free tier limits
Inaccurate suggestions	Provide more context with file references
Privacy concerns	Use local models via Ollama for sensitive code

Resources

• 官方文档
• 官网
• GitHub 讨论