Cursor AI 安装、使用方法详细全解

Cursor AI 安装、使用方法详细全解

数据来源：Cursor 官方文档与定价页、社区评测、Reddit 讨论、第三方对比文章

一、项目概述

核心理念

Cursor 是一款将 AI 深度集成到编辑器核心中的代码编辑器。与"在编辑器上安装 AI 插件"的思路不同，Cursor 从底层架构上将 AI 作为一等公民——从自动补全、代码理解、多文件编辑到终端操作，每一步都可以通过 AI 增强。它兼容 VS Code 的扩展生态和快捷键体系，使迁移成本极低。

二、核心功能特性

1. Tab 智能补全

• 自研 Tab 模型，支持多行代码预测（Fill-in-the-Middle 技术）
• 分析整个代码库上下文，而非仅当前文件
• 学习用户编辑习惯和项目模式
• 支持所有文件类型（代码、配置、SQL、Shell 脚本等）
• 速度业界领先，延迟极低

2. AI Chat 对话面板

• 上下文感知的 AI 助手侧栏
• 支持多轮对话，参考打开的文件和选中的代码
• 支持图片上传（截图、设计稿、架构图）
• @ 引用系统：@Files、@Codebase、@Git Changes、@Terminal、@Tests、@Web、@Docs、@Issues、@Canvas

• 引用系统：#Files、#Folders、#URL、#Tests

3. Composer / Agent 模式

• Cursor 最强大的功能——AI 驱动的多文件编辑
• 描述高层需求，Cursor 自动规划并跨整个代码库执行
• 支持同时修改 10-100+ 个文件
• Agent 模式下可自主运行终端命令、读取文件、执行测试、调试
• 200K token 上下文窗口
• 支持预览所有拟变更的 diff 后再确认

4. 云端 Agent（Cloud Agents）

• 通过浏览器、手机或 Slack/GitHub/Linear 等工具访问云端 Agent
• 地址：cursor.com/agent
• Agent 在云端拥有独立计算环境，可自主工作
• 支持高达 20 个 Agent 并行

5. Cursor CLI

• 命令行界面，支持 Shell 交互模式和 Headless 无头模式
• 可集成到 CI/CD 流水线
• 支持 ACP 协议
• 可与 JetBrains、Xcode 等 IDE 配合使用

6. Cursor Review / Bugbot

• AI 驱动的代码审查
• PR 收件箱、PR 页面、合并队列
• Bugbot：Agent 自主审查 Pull Request

7. 代码库索引

• 全自动代码索引，理解项目结构和依赖关系
• RAG（检索增强生成）语义搜索
• 支持任意规模代码库

8. 自定义系统

• Rules：项目级/全局级 AI 规则
• Skills：可复用的 AI 能力模块
• Sub-agents：子代理
• Hooks：钩子机制
• MCP：Model Context Protocol 支持

9. 语音模式

• Cmd+Shift+Space / Ctrl+Shift+Space 激活语音输入
• 语音指令操作编辑器

10. 第三方集成

• Slack、Microsoft Teams、Jira、Linear、GitHub、GitLab
• JetBrains IDE、Xcode

11. 最新功能（Cursor 3.5-3.7）

• Shared Canvases（3.5）：分享工作区快照链接
• /loop Skill（3.5）：AI 生成代码→测试→根据失败自动重试
• Auto-Review Run Mode（3.6）：Agent 自主审批白名单操作，减少人工确认
• Canvas Design Patterns & Context Usage Reports（3.7）

三、安装步骤

系统要求

安装方法

方法一：官方桌面应用（推荐）

1. 访问 https://cursor.com/download
2. 选择对应平台的安装包：
   • macOS：Mac (ARM64) / Mac (x64) / Mac Universal
   • Windows：Windows x64（系统安装/用户安装）/ Windows ARM64
   • Linux：.deb（x64/ARM64）、RPM（x64/ARM64）、AppImage（x64/ARM64）
3. 运行安装程序，按提示完成
4. 首次启动后登录/注册账号
5. 桌面应用支持自动更新

方法二：从 VS Code 迁移

1. 安装 Cursor 桌面应用
2. 首次启动时选择"Import from VS Code"
3. 一键导入 VS Code 的：
   • 扩展列表
   • 主题
   • 快捷键绑定
   • 用户设置
4. 导入完成后即可开始使用

方法三：浏览器访问

• 访问 cursor.com/agent 即可在浏览器中使用 Cloud Agent
• 支持移动端浏览器访问

方法四：CLI 安装

• 安装 Cursor CLI 命令行工具
• 支持 Shell 模式（交互式）和 Headless 模式（CI/CD）

首次使用配置

1. 登录账号：注册/登录 Cursor 账号（免费/付费）
2. 导入设置：从 VS Code 导入扩展和主题
3. 选择 AI 模型：在设置中选择默认 Chat 和 Tab 模型
4. 配置 .cursorrules：在项目根目录创建规则文件
5. 安装常用扩展：Prettier、ESLint、GitLens 等（兼容 VS Code 扩展）

四、使用方法详解

1. AI Chat 对话面板（Ctrl+L / Cmd+L）

打开方式：

Chat 输入快捷键：

@ 引用系统（输入 @ 打开）：

• @Files：引用特定文件
• @Codebase：包含整个代码库（语义搜索）
• @Git Changes：包含未提交的更改
• @Terminal：包含终端输出
• @Tests：包含测试文件
• @Web：搜索网页并包含结果
• @Docs：引用文档
• @Issues：引用 Issue 跟踪器（GitHub/Linear/Jira）
• @Canvas：引用画板

# 引用系统（输入 # 打开）：

• #Files：指定文件路径
• #Folders：整个目录
• #URL：网页 URL 作为上下文
• #Tests：测试文件位置

接受/拒绝代码更改：

• Cmd+Enter / Ctrl+Enter：接受所有建议
• Cmd+Delete / Ctrl+Backspace：拒绝所有建议
• 单条更改有行内 diff 接受/拒绝按钮

Chat 典型用法：

# 理解代码 选中代码 → Cmd+Shift+L → "这段代码的作用是什么？" # 代码库搜索 Cmd+L → @Codebase → "项目中如何处理用户认证？" # 调试错误 Cmd+L → 粘贴错误信息 → "帮我找出这个错误的原因" # 代码生成 Cmd+L → @Files（选相关文件） → "基于这个接口写一个 React 组件" # 搜索网页 Cmd+L → @Web → "React 19 有什么新特性？"

2. Composer 模式（Ctrl+I / Cmd+I）

打开方式：

什么是 Composer：

Composer 是 Cursor 最强大的功能——AI 驱动的多文件编辑工作流。你用自然语言描述一个需求，Cursor 自动分析整个代码库、制定计划、修改多个文件。

核心能力：

• 同时修改 10-100+ 个文件
• 架构级重构（重命名服务、修改接口、迁移模式）
• 从零生成新文件、组件、模块
• 完全理解代码库上下文
• 预览所有 diff 后再确认

Composer 工作流程：

1. Cmd+I 打开 Composer
2. 用自然语言描述需求（例如：“给所有 API 调用添加错误处理”）
3. Cursor 分析代码库并提议更改
4. 预览所有受影响的文件的 diff
5. Cmd+Enter 接受或修改提示继续迭代

Agent 模式下的额外能力：

• 自主运行终端命令
• 读取未展示的文件
• 根据错误反馈自动迭代
• 执行测试验证更改
• 发起 HTTP 请求检查 API

Composer 使用建议：

• 使用具体、有范围的提示而非模糊描述
• 添加 @ 引用：“@Codebase 重构支付流程”
• 大型重构拆分为多个小步骤
• 使用 Cmd+E 全屏分屏视图（代码 + Composer 并排）

典型场景：

# 多文件重命名 "将 UserService 重命名为 AccountService，更新所有引用" # 添加功能 "在所有 API 端点添加速率限制中间件" # 迁移框架 "将 CSS 从 Tailwind 迁移到 CSS Modules" # 修复 bug "找出并修复所有内存泄漏"

3. 行内编辑（Ctrl+K / Cmd+K）

打开方式：Cmd+K (Mac) / Ctrl+K (Win/Linux)

核心工作流：

1. 选中代码（或将光标放在要插入代码的位置）
2. 按 Cmd+K
3. 在行内提示框中输入指令
4. Cursor 在编辑器中生成 diff 预览
5. Cmd+Enter 接受，Cmd+Delete 拒绝

常见用法：

终端 AI 命令：

• 在集成终端中按 Cmd+K 打开 AI 提示
• 用自然语言描述想要的命令
• 按 Cmd+Enter 执行生成的命令

核心编辑链（形成肌肉记忆）：

选中代码 → Cmd+K → 描述变更 → Enter → Cmd+Enter 接受

4. Tab 自动补全

使用方法：

• 输入时 Cursor 自动显示灰色预览文本
• 按Tab接受完整建议
• 按Cmd+Right / Ctrl+Right逐字接受
• 按Escdismiss 建议

使用技巧：

• 让 Cursor 先建议完整代码块再按 Tab，经常能一次补全整个函数
• 使用 Cmd+Right 逐字接受以进行部分修正
• 支持所有文件类型（代码、配置、SQL、Shell）

5. Agent 模式切换（Cmd+. / Ctrl+.）

三种 AI 行为模式：

Agent 模式（默认）：

• AI 自主行动——编辑文件、运行命令、读取文件、迭代
• 完整访问终端、文件系统和代码库
• 适用：复杂重构、功能实现、调试

Ask 模式：

• AI 提供建议/解释但不会主动修改
• 必须手动接受更改
• 适用：学习、代码审查、理解陌生代码

Plan 模式：

• AI 先制定分步计划，再逐步执行
• 适用：大型架构变更、迁移

切换方式：

• Cmd+. / Ctrl+. 打开模式菜单
• Shift+Tab 在 Agent/Ask/Plan 间循环

6. 斜杠命令

在 Chat 或 Composer 中输入 / 打开命令列表：

7. 语音模式

• 激活：Cmd+Shift+Space / Ctrl+Shift+Space
• 语音指令示例：
  • “Cursor, add error handling to this function”
  • “Cursor, explain what this code does”
  • “Cursor, find all usages of this variable”

8. 快捷键完整参考

Cursor 专用快捷键：

VS Code 继承快捷键（常用）：

9. 复合快捷键链（日常工作流）

# 1. 行内编辑循环 选中代码 → Cmd+K → 描述变更 → Enter → Cmd+Enter 接受 # 2. 语义搜索 + Q&A Cmd+L → @Codebase → 输入问题 # 3. 终端 AI 命令 终端 → Cmd+K → 自然语言描述 → Cmd+Enter 执行 # 4. 多文件更改 Cmd+I → 描述需求 → 预览 diff → Cmd+Enter 接受 # 5. 深度工作 Cmd+E → Cmd+I（全屏 Agent + Composer 分屏）

五、配置详解

1. Cursor 设置（Cmd+Shift+J / Ctrl+Shift+J）

AI 规则（Rules for AI）：

• 全局规则：对所有项目生效
• 编码风格、语言偏好、错误处理策略

API 配置：

• API 密钥设置
• 支持自定义模型提供商

Tab 补全设置：

• 启用/禁用
• 模型选择
• 延迟调整

Composer 设置：

• 默认模型
• Agent 模式开关

Chat 设置：

• 默认模型
• 上下文设置

2. .cursorrules 规则系统

Cursor 拥有 5 层规则体系：

第一层：全局规则（Settings）

• 位置：Cursor Settings > Cursor Settings > Rules for AI
• 对所有项目全局生效
• 通过 Cmd+Shift+J 访问

第二层：项目规则 — .cursor/index.mdc

• 位置：仓库根目录.cursor/index.mdc
• 替代旧版.cursorrules文件
• 规则类型：“Always”——对此项目的所有 AI 交互生效
• 内容：项目特定约定、架构说明、技术栈信息

第三层：动态规则 — .cursor/rules/*.mdc

• 位置：.cursor/rules/目录下的.mdc文件
• 规则类型：“Dynamic”——仅当 AI 处理与该规则描述相关的任务时激活
• 示例文件：testing.mdc、api.mdc、frontend.mdc

旧版：.cursorrules（已弃用但仍支持）

• 仓库根目录的单个文件，向后兼容

示例 .cursor/index.mdc：

--- description: 项目级编码规范 globs: * --- ## 通用 - 使用 TypeScript strict mode - 所有组件放在 /src 目录 - 严格遵循现有命名约定 - 注释仅使用英文 ## 架构 - 基于功能的文件夹结构 - API 路由在 /app/api/ - 共享工具在 /lib/ - 类型定义在 /types/

规则编写建议：

1. 全局规则：个人编码风格
2. 项目规则：架构约定
3. 动态规则：场景特定指导
4. 保持简洁——AI 每次交互都会读取所有规则
5. 包含否定约束：“不要使用 X 模式”
6. 引用现有代码：“遵循 /src/examples/ 中的模式”
7. 社区仓库：PatrickJS/awesome-cursorrules（40k+ stars）

3. 可用的 AI 模型

切换模型：

• Cmd+/ / Ctrl+/：循环切换可用模型
• Cmd+Alt+/ / Ctrl+Alt+/：在 Chat 中切换
• 侧栏底部模型选择器

模型选择策略：

• Claude Sonnet/Opus：Composer 模式、复杂重构、架构设计
• GPT-4o/Codex：Chat、快速问答、代码解释
• Cursor Fast：Tab 补全、简单行内编辑
• Auto：让 Cursor 自动选择（推荐大多数场景）

支持本地 LLM：

• 通过 OpenRouter 或 LM Studio 连接本地模型
• 实现完全离线运行（隐私模式）

4. 扩展管理

• 完整兼容 VS Code 扩展
• Cmd+Shift+X / Ctrl+Shift+X 打开扩展管理
• Cursor 也有自己的扩展市场
• 推荐安装：Prettier、ESLint、GitLens、Error Lens

MCP 支持：

• 在设置中配置 MCP 服务器
• 从外部来源获取结构化上下文
• 支持自定义工具集成

六、典型应用场景

场景 1：日常编码

Tab 自动补全 → Cmd+K 行内编辑 → Cmd+L 快速问答

日常开发中，Tab 补全自动完成大部分代码输入，遇到不确定的地方用 Cmd+K 快速生成/修改代码，用 Cmd+L 查询 API 文档或理解依赖库。

场景 2：代码审查

Cmd+L → 粘贴 PR 链接或选中代码 → "审查这段代码，找出潜在问题"

利用 AI 进行代码审查，发现潜在 bug、性能问题和安全隐患。Cursor Review 内置 AI 驱动的 PR 审查功能。

场景 3：大型重构

Cmd+I → "将 Express 路由迁移到 Fastify" → 预览 diff → Cmd+Enter

Composer 模式跨整个代码库进行搜索和替换，处理依赖关系和引用更新，比手动重构快 40%。

场景 4：调试

Cmd+L → 粘贴错误信息 → "分析这个错误" → Cmd+K（在错误行） → "修复这个问题" → 终端 Cmd+K → "运行失败的测试"

Chat 分析错误、行内编辑应用修复、终端 AI 执行测试验证。

场景 5：学习新代码库

Cmd+L → @Codebase → "解释项目的整体架构" Cmd+L → @Files → "这个文件在项目中的作用是什么？" Cmd+L → @Codebase → "用户认证流程是怎样的？"

通过语义搜索和 AI 解释快速理解陌生代码库。

场景 6：编写测试

Cmd+K（选中函数） → "写单元测试" 或 Cmd+L → @Files → "为这个模块编写集成测试"

自动生成单元测试和集成测试。

场景 7：终端操作

终端 → Cmd+K → "列出所有未推送的提交" → Cmd+Enter 执行

用自然语言描述终端命令，AI 生成并执行。

七、竞品对比

Cursor vs VS Code + GitHub Copilot

Cursor vs Windsurf

Cursor vs Claude Code

Cursor vs Devin

社区共识

• Cursor 日常编码最佳选择：Tab 补全速度、多文件编辑、Chat 重构能力领先
• Cursor + Claude Code 组合：日常编辑用 Cursor，大型重构用 Claude Code
• 预算敏感用户：VS Code + Copilot 性价比更高
• 企业用户：需评估代码发送到云端的供应链风险

八、成本分析

定价方案（2026 年 6 月）

个人计划：

用量池机制（个人计划）：

• Auto + Composer 池：使用 Auto 或 Composer 2.5 模型时包含大量免费用量
• API 池：按各模型 API 价格计费，Pro 计划含 $20/月 API 额度

Auto 模型定价：$1.25/M 输入+缓存写入, $6.00/M 输出, $0.25/M 缓存读取
Composer 2.5 定价：$0.50/M 输入

团队计划：

企业计划（定制报价）：

• 所有 Team 功能 + 聚合用量、发票/采购订单计费、SCIM 席位管理、代码库/模型/MCP 访问控制、自动运行/浏览器/网络控制、审计日志、AI 代码跟踪 API、优先级支持

成本节省技巧

1. 简单任务使用 cheaper 模型（Cursor Fast / Cursor Small）
2. 合理使用 Auto 模式（Cursor 自动选择性价比最优模型）
3. 利用 Composer 2.5 模型的低价用量池
4. 团队选择 Teams 计划获得更好的企业功能
5. 处理敏感代码时连接本地 LLM 避免 API 费用

九、安全性与隐私

数据流向

• 默认情况下代码会发送到云端：代码片段和 prompt 发送到 AWS 及模型提供商（OpenAI、Anthropic、Google 等）
• 代码索引本地处理：但 AI 请求需发送到模型 API
• Cloud Agent 是唯一需要 Cursor 存储代码的功能

隐私模式

• 启用后：零数据保留——代码不存储在 Cursor 服务器，不用于模型训练
• 用户或团队/企业管理员可在设置中启用
• 即使未启用，数据保留期有限（30 天日志）

认证与合规

• SOC 2 Type II 认证
• 企业级数据治理和子处理器透明化
• 支持本地 LLM（OpenRouter / LM Studio），实现完全离线

安全风险

• AI 生成代码可能包含安全漏洞
• 可能泄露凭证（API key、token）
• 代码传输到第三方模型提供商存在供应链风险
• 企业用户建议启用隐私模式并审查 AI 生成代码

十、常见问题

Q1：Cursor 和 VS Code 有什么区别？

Cursor 是 VS Code 的 fork，但将 AI 深度集成到内核中。VS Code 的 AI 是通过 Copilot 扩展附加的。Cursor 支持多文件 Agent 编辑、更强大的 Tab 补全、200K 上下文窗口和云端 Agent。

Q2：Cursor 免费吗？

Hobby 计划免费（2000 次补全 + 50 次 premium 请求），够用入门。Pro 计划 $20/月起。

Q3：可以从 VS Code 迁移吗？

可以。首次启动时选择"Import from VS Code"，一键导入扩展、主题和设置。

Q4：支持哪些 AI 模型？

支持 OpenAI（GPT-5.5/5.3 Codex）、Anthropic（Claude 4.6 Sonnet/Opus 4.8）、Google（Gemini 3.1 Pro/3.5 Flash）、xAI（Grok）、Cursor 自有模型（Auto/Composer 2.5）等。

Q5：支持本地 LLM 吗？

支持。通过 OpenRouter 或 LM Studio 连接本地模型，实现完全离线运行。

Q6：代码会泄露吗？

默认会发送到云端模型提供商，但可启用隐私模式实现零数据保留。企业用户建议使用隐私模式或本地 LLM。

Q7：Cursor 有什么常见问题？

• 大型文件（500+ 行）处理较慢
• 偶发代码静默回滚（与 Format On Save 冲突）
• 免费层使用量有限
• 部分 VS Code 扩展不兼容

十一、最佳实践

提示词工程

1. 给出明确约束：“保持 50 行以内”、“使用 TypeScript strict mode”
2. 提供上下文：指定"这是 10k 用户的生产应用"
3. 打开相关文件：提问前打开相关文件或选中代码，提升 AI 准确性
4. 不要指望 AI 写所有代码：目标是消除打断心流的摩擦

设置优化

1. 关闭 Format On Save 避免代码静默回滚
2. 使用 .cursor/index.mdc 定义项目级规则
3. 针对 Monorepo 为不同子项目分别配置规则
4. Tab 补全使用 Cursor Fast 模型
5. Composer/Chat 使用 Claude 或 Auto 模型

工作流建议

1. 日常编码：Tab 补全 + Cmd+K 行内编辑
2. 理解代码：Cmd+L + @Codebase
3. 多文件重构：Cmd+I + Agent 模式
4. 调试：Cmd+L 错误分析 + Cmd+K 行内修复
5. 终端：Cmd+K 自然语言命令
6. 组合使用：Cursor（日常） + Claude Code（大型重构）

大文件处理

• 单文件超过 500 行时 AI 编辑可能较慢
• 建议分块处理，避免一次性让 AI 编辑整个大文件
• 使用 Cmd+K 在小范围进行精准修改

十二、学习资源

官方资源

• 官网：https://cursor.com
• 文档：https://cursor.com/docs
• 下载：https://cursor.com/download
• 定价：https://cursor.com/pricing
• Cloud Agent：https://cursor.com/agent

社区资源

• PatrickJS/awesome-cursorrules（40k+ stars）：社区维护的 Cursor 规则模板
• Reddit r/ChatGPT 和 r/programming：Cursor 讨论
• Cursor 官方 Discord：社区支持

教程视频

• YouTube 上的 Cursor AI Tutorial（多个入门教程）
• 搜索 “Cursor AI tutorial 2026” 获取最新教程

十三、总结与建议

优势

1. Tab 补全速度业界领先——多行预测，基于整个代码库上下文
2. 多文件 Agent 编辑能力——Composer 模式可同时修改 10-100+ 文件
3. 模型选择多样——支持 OpenAI、Anthropic、Google、xAI 等
4. 200K token 上下文窗口——理解大型代码库
5. 兼容 VS Code 生态——扩展和快捷键几乎零学习成本
6. 云端 Agent——通过浏览器/移动端随时随地编码
7. 企业功能完善——SOC 2 合规、SSO、隐私模式

劣势

1. 价格较高——Pro $20/月，是 Copilot 的 2 倍
2. 免费层限制——2000 次补全 + 50 次 premium 请求
3. 大文件处理慢——500+ 行文件可能卡顿
4. 偶发 bug——代码静默回滚、偶发崩溃
5. 代码上传云端——默认将代码发送到第三方模型

适用人群

• 个人开发者：Cursor 是目前综合体验最好的 AI 代码编辑器
• 团队：Teams/Enterprise 计划适合需要企业级功能的团队
• 预算敏感用户：可先用 Hobby 免费层或 VS Code + Copilot
• 安全敏感项目：启用隐私模式或连接本地 LLM

快速上手建议

1. 下载安装 Cursor 并导入 VS Code 设置
2. 先用 Hobby 免费层体验 Tab 补全和 Chat
3. 掌握三个核心快捷键：Cmd+K（行内编辑）、Cmd+L（Chat）、Cmd+I（Composer）
4. 创建 .cursor/index.mdc 定义项目规则
5. 熟悉 Agent/Ask/Plan 三种模式
6. 升级到 Pro 解锁高级模型和 Agent 功能