Cursor 介绍与安装配置

什么是 Cursor？

Cursor 是由 Anysphere 公司开发的 AI 原生代码编辑器，于 2023 年正式发布，2024 年进入爆发式增长阶段，2025-2026 年已成为全球最受欢迎的 AI 编程工具之一。 与那些在传统编辑器上"贴上"AI 插件的方案不同，Cursor 从设计之初就将 AI 能力深度融入编辑器的每一个角落。

Cursor 的核心理念可以用一句话概括：让 AI 成为真正了解你项目的协作者，而不只是一个会背代码片段的自动补全工具。 它能够索引整个代码库，理解项目架构，跨文件进行推理，甚至以 Agent 身份自主执行多步骤任务。

Cursor 的核心功能矩阵

• Tab 智能补全（Tab Completion） 基于光标上下文预测多行代码，支持接受整段建议或逐词接受，理解注释意图生成实现。
• Cmd+K 内联编辑（Inline Edit） 在选中代码上方唤起内联对话框，输入自然语言指令即可重写、解释、优化选中代码段，实时 diff 预览。
• Cursor Chat（对话面板） 全功能 AI 对话界面，支持 @引用文件/函数/文档/网页，能够 Apply 代码到编辑器，维护多轮对话上下文。
• Agent 模式 AI 自主规划并执行多步任务：搜索代码库、读写文件、运行终端命令、调用 MCP 工具，完成复杂工程任务。
• Background Agent（后台代理） 在云端远程沙箱中并行运行 Agent，可同时处理多个任务，自动生成 Pull Request。
• MCP 集成（Model Context Protocol） 通过标准协议连接数据库、浏览器、第三方 API 等外部工具，极大扩展 AI 的行动能力。
• 规则系统（Rules） .cursorrules 文件与 Project Rules 定义 AI 的行为规范，确保代码风格一致性，支持团队共享。

与 VS Code 的关系

Cursor 是基于 VS Code 的开源核心（Code - OSS）深度定制的 fork。这意味着：

为什么不用 GitHub Copilot？

Copilot 是优秀的补全工具，但 Cursor 提供了更完整的 AI 编程生态：

AI 模型选择

Cursor 的核心竞争力之一是可以自由选择并切换底层 AI 模型。不同模型各有擅长，了解它们有助于选择最合适的场景配置。

主流模型对比（2025-2026）

• Claude 3.5 / 3.7 Sonnet（推荐） Anthropic 出品，代码能力顶尖，指令遵循性极强，上下文窗口 200K，支持扩展思考（Extended Thinking）。在复杂重构、架构设计、多文件编辑任务中表现最优，是 Cursor 默认主推模型。
• GPT-4o / o1 / o3（OpenAI） GPT-4o 速度快、综合能力强；o1/o3 系列为推理模型，擅长算法和数学问题。对于需要深度推理的编程挑战可切换至 o3。
• Gemini 2.0 Flash / Pro（Google） Gemini Flash 速度极快，适合简单补全任务；Pro 版本上下文窗口达 1M，适合超大型代码库的全局分析。
• cursor-small（Cursor 自研） Cursor 自训练的小型模型，延迟极低，不消耗 API 请求额度，适合高频的 Tab 补全场景。
• 自定义 API（BYOK） Bring Your Own Key — 可配置 OpenAI、Anthropic、Azure OpenAI、Ollama（本地）等自定义端点，使用自己的 API Key，费用自理，不消耗 Cursor 额度。

如何切换模型

在 Cursor Chat 面板底部，点击模型名称下拉菜单即可实时切换。不同的对话可以使用不同的模型，互不影响。快捷键 Cmd+/（Mac）或 Ctrl+/（Windows）可快速唤起模型选择。

安装与首次运行

下载安装

前往 cursor.com 官网下载对应平台安装包：

• macOS：下载 .dmg，拖拽至 Applications，首次打开需在系统偏好设置中允许运行
• Windows：下载 .exe 安装器，支持 x64 / ARM64，推荐安装至默认路径
• Linux：提供 .deb、.rpm 和 AppImage 格式，Ubuntu/Debian 用户推荐 .deb

首次启动配置向导

安装后首次启动会进入配置向导，包含以下步骤：

1. 导入 VS Code 配置：可一键导入扩展列表、设置、快捷键、主题，强烈建议执行
2. 登录账号：使用 GitHub、Google 或 Email 注册/登录
3. 选择键盘方案：Cursor 默认、VS Code 兼容（几乎相同）
4. 选择默认 AI 模型：推荐选 Claude 3.7 Sonnet
5. 隐私设置：选择是否开启隐私模式（见下文）

代码库索引（Codebase Indexing）

打开项目文件夹后，Cursor 会自动开始扫描并建立代码库的语义索引。这个过程可能需要数秒到数分钟（取决于项目规模）。 索引完成后，Chat 的 @Codebase 引用和"在整个代码库中搜索"功能才会准确工作。

可在状态栏右下角看到索引进度。索引数据存储在本地缓存，后续增量更新。

# .cursorignore — 排除不需要索引的目录（语法同 .gitignore）
node_modules/
.git/
dist/
build/
*.lock
*.log
__pycache__/
.venv/

账号与订阅方案

Cursor 提供四个层级的订阅方案（2025-2026 年定价，以官网为准）：

BYOK 模式（自带 API Key）

在 Cursor Settings → Models 中，可以添加自己的 Anthropic、OpenAI、Google、Azure OpenAI API Key。 使用 BYOK 模式时不消耗 Cursor 的请求额度，直接走第三方 API 账单，适合用量极大的重度用户。

核心设置详解

Cursor 的 AI 相关设置集中在 Cursor Settings（区别于 VS Code 的标准 Settings，通过 Cmd+Shift+J 打开）。

重要设置项

• General → Default AI Model 设置 Chat 和 Cmd+K 的默认模型。建议设为 Claude 3.7 Sonnet。
• Features → Cursor Tab 控制 Tab 补全的开关、触发延迟、是否显示幽灵文字（ghost text）。默认开启即可。
• Features → Codebase Indexing 管理项目索引，可手动重建索引（Resync），查看已索引文件数量。
• Features → Auto-scroll in Chat 对话时自动滚动到最新回复，推荐开启。
• Beta → Background Agent 开启云端并行 Agent 功能（需 Pro 及以上）。
• Privacy → Privacy Mode 开启后，代码片段不会被 Anthropic/OpenAI 等用于模型训练（见下文）。

推荐的 settings.json 配置片段

{
  // Cursor AI 推荐配置
  "cursor.general.gitIntegration": true,
  "cursor.chat.smoothStreaming": true,
  "cursor.tab.enabled": true,
  "cursor.tab.showGhostText": true,

  // 编辑器基础配置
  "editor.fontSize": 14,
  "editor.lineHeight": 1.7,
  "editor.fontFamily": "'JetBrains Mono', 'Fira Code', monospace",
  "editor.fontLigatures": true,
  "editor.formatOnSave": true,
  "editor.minimap.enabled": false,
  "editor.stickyScroll.enabled": true
}

隐私模式与企业安全

隐私模式（Privacy Mode）

开启隐私模式后，Cursor 保证：你的代码片段不会被任何 AI 提供商（Anthropic、OpenAI 等）用于模型训练。 在企业和专业场景下，强烈建议开启此选项，尤其是处理敏感代码库时。

路径：Cursor Settings → General → Privacy Mode → Enabled

Enterprise 合规能力

• SOC 2 Type II 认证：Cursor 已通过安全合规审计
• SAML/SSO 集成：支持 Okta、Azure AD 等企业身份提供商
• 私有部署（Self-hosted）：Enterprise 方案可将 AI 推理托管在企业自有基础设施
• 网络代理支持：支持配置 HTTP_PROXY，适配企业网络环境
• IP 允许列表：可配置指定 IP 才能访问团队功能

本地模型（完全私有）

如果对数据出境有严格要求，可以通过 BYOK + Ollama 在本地运行 AI 模型（如 Qwen2.5-Coder、DeepSeek-V3 等）。 在 Cursor Settings → Models 中配置 Ollama 的本地端点 http://localhost:11434，选择本地模型即可。 注意本地模型的质量和速度通常低于云端旗舰模型，适合对隐私要求极高的场景。

# Cursor Settings → Models → Custom API
Base URL:  http://localhost:11434/v1
API Key:   ollama  # 随便填
Model:     qwen2.5-coder:32b