Cursor 入门与基础操作

本文属于《从 0 到 1 AI 产品出海知识库》中的「AI 编程工具入门」章节。

2025 年，AI 编程工具领域发生了一件标志性事件：Cursor 的用户量突破千万，成为开发者讨论中出现频率最高的 AI 代码编辑器。它不是 VS Code 的插件，而是在 VS Code 开源代码基础上重新构建的独立编辑器——把 AI 能力直接嵌入编辑器的核心，而不是像 GitHub Copilot 那样作为附加层存在。

对于没有编程基础、但想借助 AI 完成产品开发的人来说，Cursor 是目前门槛最低的选择之一。这篇文章从零开始，带你走完安装、配置到核心功能使用的全过程。

安装与初始设置

下载与安装

前往 cursor.com 点击下载按钮，网站会自动识别你的操作系统（macOS / Windows / Linux）。下载完成后：

• macOS：打开 .dmg 文件，将 Cursor 拖入 Applications 文件夹
• Windows：运行 .exe 安装程序，按提示完成安装
• Linux：提供 .AppImage 格式，下载后赋予执行权限即可运行

首次启动时，Cursor 会询问你是否要导入 VS Code 的配置。

导入 VS Code 配置

如果你之前用过 VS Code，强烈选择「是」。Cursor 会一键导入以下内容：

• 已安装的扩展（Extensions）
• 快捷键配置
• 主题和外观设置
• 用户级别的 settings.json

这一步能节省大量重新配置的时间。如果你是从零开始，跳过这一步也不影响后续使用。

登录与订阅

Cursor 需要注册账号才能使用 AI 功能。打开编辑器后，点击右上角的头像图标，选择「Sign In」。支持邮箱注册和 Google 账号登录。

免费版（Hobby）可以体验基础功能，但有用量限制。对于认真想用它做项目的人来说，Pro 计划（$20/月）是起步选择。具体定价方案见后文对比。

界面介绍：和 VS Code 的异同

打开 Cursor 之后，你会发现它和 VS Code 长得几乎一样。这不是巧合——Cursor 本身就是从 VS Code 的开源仓库（Code - OSS）分叉出来的。左侧的文件资源管理器、顶部的标签栏、底部的终端面板、命令面板（Cmd/Ctrl + Shift + P），这些你熟悉的操作全部保留。

主要的视觉差异在于以下几个位置：

1. 右侧边栏的 Chat 面板：这是 Cursor 新增的核心交互区域，默认显示 AI 对话窗口
2. 顶部工具栏的 AI 模式切换：在部分版本中可以看到 Chat / Composer / Agent 的模式选择入口
3. 编辑器内的灰色预览文字：当 Tab 补全触发时，你会在光标位置看到半透明的建议代码
4. Cmd+K 的内联输入框：选中代码后按下快捷键，会在代码上方弹出一个输入区域

如果你已经熟练使用 VS Code，上手 Cursor 不需要额外学习成本。所有的快捷键、扩展市场（注意：Cursor 使用的是 Open VSX Registry，少部分微软专有扩展不可用）、终端操作都保持一致。

核心功能详解

Cursor 的 AI 能力可以拆成五个层次，从最轻量的代码补全到最自主的 Agent 模式，覆盖不同粒度的编辑需求。

1. Tab 智能补全

触发方式：自动触发，按 Tab 键接受建议

Tab 补全是 Cursor 最基础也最常用的功能。和传统的代码补全不同，它不是逐词预测，而是「下一步动作预测」——它会根据你当前的编辑上下文、最近修改的文件、光标位置，推断你接下来想做什么，然后给出可能跨越好几行甚至跨文件的建议。

举一个具体场景：你刚在一个 React 组件里新增了一个 useEffect，光标移动到组件底部。Tab 可能会建议你顺便更新 useEffect 的依赖数组，甚至在相邻组件中做对应的修改。

使用技巧：

• 写代码时保持正常的打字节奏，Tab 建议会在你停顿或换行时出现
• 看到灰色预览文字后，按 Tab 接受，按 Esc 忽略
• 如果建议不对，不要急着按 Tab，继续打你想要的代码，Cursor 会根据你的输入调整
• 连续按 Tab 可以逐步接受多行建议

根据 Cursor 官方的数据，更新后的 Tab 模型「减少了 21% 的建议数量，但接受率提升了 28%」，意味着建议精度更高，无效干扰更少。

2. Cmd+K / Ctrl+K 内联编辑

触发方式：选中代码后按 Cmd+K（macOS）或 Ctrl+K（Windows/Linux）

Cmd+K 是「在原地改代码」的功能。你选中一段代码，按下快捷键，编辑器会在代码上方弹出一个输入框，你用自然语言描述你想要的修改，AI 直接在当前位置生成修改后的代码。

具体操作步骤：

1. 用鼠标或键盘选中你想修改的代码段（比如一个函数）
2. 按下 Cmd+K
3. 在弹出的输入框中输入修改意图，例如：「把这个函数改成异步的，加上错误处理」
4. 按回车发送
5. Cursor 会在原位置显示修改后的代码（diff 视图），你可以逐行对比
6. 点击「Accept」接受修改，或「Reject」撤销

适合场景：

• 修改单个函数或代码块的逻辑
• 给函数添加类型注解
• 把一段代码重构成更简洁的写法
• 给函数加注释或 JSDoc 文档
• 把一段 Python 代码改写成 TypeScript

Cmd+K 的修改范围是「当前选中的代码块」，不会动其他文件。如果你需要跨文件修改，应该使用 Composer。

3. Chat 侧边栏对话

触发方式：Cmd+L（macOS）或 Ctrl+L（Windows/Linux），或点击右侧 Chat 面板图标

Chat 是 Cursor 的「问答助手」。它不会直接修改你的代码，而是通过对话帮你理解代码、分析问题、提供方案建议。

基本用法：

1. 按 Cmd+L 打开 Chat 面板
2. 在输入框中用自然语言提问，例如：「这个项目里的认证逻辑是怎么工作的？」
3. AI 会阅读你的项目代码并给出回答，回答中会引用具体的文件和代码行
4. 如果 AI 给出的代码片段你觉得可以用，点击代码块上方的「Insert」按钮插入到当前文件

配合 @ 引用使用（详见后文「@ 引用」小节）：

• @file 引用某个文件，让 AI 基于该文件内容回答
• @folder 引用整个文件夹
• @codebase 让 AI 搜索整个代码库
• @web 让 AI 联网搜索

Chat vs Cmd+K 的选择逻辑：

• 需要理解代码、讨论方案 → Chat
• 需要直接修改当前代码 → Cmd+K
• 需要跨多个文件修改 → Composer

4. Composer 多文件编辑

触发方式：Cmd+I（macOS）或 Ctrl+I（Windows/Linux）

Composer 是 Cursor 最强大的编辑功能之一。它的定位是「任务级」的代码生成和修改——你描述一个完整的任务，Composer 会跨多个文件创建、修改代码，完成整个功能。

具体操作步骤：

1. 按 Cmd+I 打开 Composer 面板
2. 描述你的任务，例如：「创建一个用户登录页面，包含邮箱和密码输入框、登录按钮、忘记密码链接，使用 Tailwind CSS 做样式，表单提交后调用 /api/auth/login 接口」
3. Composer 会列出它计划创建或修改的文件清单
4. 逐一查看每个文件的变更，点击「Accept」确认
5. 全部确认后，所有文件变更生效

Composer 和 Chat 最大的区别在于：Chat 是「给建议，你自己动手」，Composer 是「直接帮你改，你审核确认」。

5. Agent 模式

触发方式：在 Composer 中切换到 Agent 模式

Agent 模式是 Composer 的进阶版本。普通 Composer 只能编辑代码文件，而 Agent 模式还可以：

• 执行终端命令（比如 npm install、pnpm dev）
• 自动读取报错信息并尝试修复
• 运行测试并根据测试结果调整代码
• 在远程虚拟机上自主完成编码任务

一个典型场景：

你在 Composer 里输入：「给项目添加用户注册功能，包含前端表单和后端 API」。Agent 模式会：

1. 分析现有项目结构
2. 创建前端注册页面组件
3. 创建后端 API 路由
4. 安装必要的依赖包
5. 运行项目看是否启动成功
6. 如果报错，自动读取错误信息并修复
7. 运行测试确认功能正常

整个过程你只需要在关键节点审核确认，不需要手动执行任何命令。

注意：Agent 模式消耗的资源（和订阅额度）比普通模式多，因为它调用了更复杂的 AI 模型并执行了实际命令。

6. @ 引用：给 AI 提供精准上下文

触发方式：在 Chat、Cmd+K 或 Composer 的输入框中输入 @

@ 引用是 Cursor 中给 AI 提供上下文的核心机制。没有 @ 引用，AI 只能靠猜测理解你的意图；有了 @ 引用，你可以精确告诉 AI「看这里」。

常用的 @ 引用类型：

实际操作示例：

假设你想让 AI 帮你修改 AuthService.ts 中的 login 方法。你应该：

1. 打开 Chat 面板（Cmd+L）
2. 输入 @AuthService.ts，选中对应文件
3. 接着输入：「把 login 方法改成支持记住登录状态，添加一个 rememberMe 参数」
4. AI 会基于该文件的完整内容给出修改建议

如果你只说「帮我改 login 方法」而不引用文件，AI 可能会找错文件，或者给出一个与你项目实际情况不匹配的方案。

对比表格

Cursor vs VS Code 功能对比

Cursor 各功能的使用场景

Cursor 定价方案对比

Cursor 适合与不适合的任务类型

实操案例

案例一：用 Cursor 创建一个 API 接口

假设你需要为博客项目创建一个「获取文章列表」的 REST API。以下是完整的操作步骤：

第一步：打开 Composer

按下 Cmd+I，打开 Composer 面板。

第二步：描述任务

在输入框中输入：

为项目创建一个获取文章列表的 API 接口。要求：
1. 路由为 GET /api/posts
2. 从项目已有的数据库模型中读取 Post 表的数据
3. 支持分页参数 page 和 pageSize
4. 返回格式为 { data: Post[], total: number, page: number }
5. 如果数据库连接失败，返回 500 错误和错误信息

第三步：查看并确认变更

Composer 会分析你的项目结构，找到已有的数据库配置文件和模型定义，然后列出它计划创建或修改的文件：

• 新增 src/api/posts/list.ts：API 路由和处理逻辑
• 可能修改 src/api/index.ts：注册新路由

逐一查看每个文件的代码变更，确认逻辑正确后点击「Accept」。

第四步：测试接口

在终端中运行项目（pnpm dev），然后用浏览器或 curl 访问 http://localhost:3000/api/posts?page=1&pageSize=10，确认返回正确的 JSON 数据。

第五步：用 Chat 排查问题（如有报错）

如果接口报错，按 Cmd+L 打开 Chat，输入：

@src/api/posts/list.ts 这个接口返回了 500 错误，
终端日志显示 "Cannot read property 'findMany' of undefined"，
帮我分析原因并修复。

AI 会基于你引用的文件内容，定位问题并给出修复方案。

案例二：用 Cursor 给现有项目添加暗色模式

假设你有一个 Next.js 项目，想添加暗色模式切换功能。

第一步：用 Chat 讨论方案

按 Cmd+L，输入：

@codebase 我的项目是 Next.js + Tailwind CSS，
想添加暗色模式切换功能。请分析项目当前结构，
给出实现方案建议。

AI 会扫描代码库，建议你使用 Tailwind 的 dark: 前缀方案，并在 layout.tsx 中添加主题切换逻辑。

第二步：用 Composer 执行实现

按 Cmd+I，输入：

根据刚才讨论的方案，实现暗色模式功能：
1. 创建 ThemeProvider 组件，使用 React Context 管理主题状态
2. 在 layout.tsx 中引入 ThemeProvider
3. 创建 ThemeToggle 组件（一个按钮，点击切换亮/暗模式）
4. 把首页的导航栏加上 ThemeToggle
5. 使用 Tailwind 的 dark: 前缀更新主要组件的样式

第三步：逐个确认文件变更

Composer 会生成多个文件的变更。逐一查看，确认每个组件的逻辑正确。

第四步：用 Cmd+K 微调样式

如果发现某个组件在暗色模式下的颜色不对，选中该组件的样式代码，按 Cmd+K，输入：「在暗色模式下把背景色改为 #1a1a2e，文字颜色改为 #e0e0e0」。

第五步：验证效果

在浏览器中打开项目，点击主题切换按钮，确认亮色和暗色模式都显示正常。

用 Cursor 完成开发任务的流程

下面这个流程图展示了用 Cursor 从零开始完成一个开发任务的完整路径：

这个流程的核心逻辑是：根据任务复杂度选择合适的工具层级。简单的局部修改用 Cmd+K，需要讨论的用 Chat，跨文件用 Composer，需要全自动的用 Agent。它们不是互斥的——一个完整的开发过程中，你可能会交替使用多个功能。

Cursor 新手上路检查清单

完成以下步骤，你就具备了用 Cursor 进行日常开发的基本能力：

环境准备

• 从官网下载并安装 Cursor
• 导入 VS Code 配置（或使用默认配置）
• 注册账号并登录
• 确认 AI 功能可用（打开 Chat 面板，输入一个问题测试）
• 安装项目需要的语言扩展（如 Python、Go、Rust 等）

核心功能掌握

• 体验 Tab 补全：新建一个文件，随便打几行代码，观察 Tab 建议并尝试接受
• 体验 Cmd+K：选中一段代码，按 Cmd+K，输入修改意图，查看 diff 并接受
• 体验 Chat：按 Cmd+L，输入 @codebase 加一个问题，让 AI 分析项目结构
• 体验 Composer：按 Cmd+I，描述一个小任务（比如「创建一个 hello world 页面」）
• 了解 @ 引用：至少用过 @file、@codebase、@web 三种引用方式

工作习惯

• 给 AI 写清晰的指令：包含具体需求、约束条件、期望输出格式
• 永远审核 AI 生成的代码再接受，不要盲目 Accept
• 了解当前订阅计划的用量额度，避免超额
• 知道何时该用 Chat 讨论、何时该用 Cmd+K 修改、何时该用 Composer 生成
• 养成用 Git 提交的习惯——AI 改代码之前先 commit，方便回滚

常见问题

Cursor 免费版够用吗？

对于偶尔写写代码、学习编程的人来说够用。但如果你每天都在用，AI 对话和补全的次数会不够。建议先试用免费版感受功能，确认适合自己后再升级 Pro。

Cursor 会替代 VS Code 吗？

短期内不会完全替代。Cursor 的扩展生态不如 VS Code 完整（缺少 Pylance、Remote SSH、Live Share 等微软专有扩展），而且需要联网才能使用 AI 功能。但如果你主要需求是写代码 + AI 辅助，Cursor 的体验已经明显优于 VS Code + Copilot 的组合。

我不懂编程，能用 Cursor 吗？

可以。Cursor 的 Agent 模式对零基础用户尤其友好——你只需要描述你想要什么，Agent 会自动创建文件、安装依赖、运行命令。但建议至少了解基础的编程概念（什么是变量、函数、文件路径），这样你和 AI 沟通时才能更准确地表达需求。

Cmd+K 和 Composer 有什么区别？

核心区别是作用范围。Cmd+K 只修改你当前选中的代码块，不碰其他文件；Composer 可以同时创建和修改多个文件，适合完成一个完整的功能。简单类比：Cmd+K 是「改一段话」，Composer 是「写一篇文章」。

小结

Cursor 的核心价值在于把 AI 能力融入到了代码编辑的每一个环节：Tab 补全让你在打字时就获得智能建议，Cmd+K 让你用自然语言修改代码块，Chat 让你随时向 AI 提问，Composer 让你一句话完成跨文件编辑，Agent 模式让 AI 像一个初级程序员一样自主完成任务。

对于 AI 产品出海的独立开发者来说，Cursor 让你可以用更少的时间完成更多的开发工作。你不需要精通每一门编程语言，但你需要学会如何与 AI 高效协作——准确描述需求、合理选择工具层级、认真审核生成结果。

下一步，我们进入进阶篇，讨论如何用 Cursor 的 Rules 功能定制 AI 行为、如何搭建高效的 AI 编程工作流。

参考资料

1. Cursor 官网 - Tab 功能介绍
2. Cursor 官方定价页面
3. Cursor Blog: Clarifying Our Pricing (2025 年 6 月定价说明)
4. DataCamp: Cursor vs. VS Code: Which One Is Right for You?
5. The Prompt Warrior: The 3 Cursor AI Modes (Chat, Composer, Agent)
6. newline: Next-Level Cursor: Cmd+K, Composer, and Agent Unpacked
7. MorphLLM: Cursor vs VS Code (2026): When Is the Fork Worth It?
8. Level Up Coding: Cursor vs. VS Code: My 2025 Developer Workflow Showdown