乐于分享
好东西不私藏

Cursor 入门指南:AI 编辑器从零上手

Cursor 入门指南:AI 编辑器从零上手

概述

Cursor 是一款 AI 编辑器和编码智能体。用自然语言描述你想要构建或修改的内容,Cursor 会为你编写代码。

工欲善其事必先利其器,认识cursor工具,才能用好工具。

价格

按月,个人pro版本20美元

按年,换算下来pro版本每月少4美元

模型

支持主流的claude系列和gpt系列大模型,以及cursor自研的composer系列大模型。

安装

下载地址

https://cursor.com/cn[1]

下载后点击安装,按步骤下一步安装即可

界面和功能介绍

编辑器模式

主界面

打开工程

打开工程,克隆仓库,连接SSH

主界面组成

菜单栏、工程栏(左侧边栏)、搜索栏、终端栏(下侧边栏)、AI对话区(右边栏)、设置、切换为agents window模式

菜单栏

菜单栏包括:文件、编辑、选择、查看、转到、运行、终端、帮助

文件

  • 新建文本文件、新建窗口、转到agents window、使用配置文件新建窗口
  • 打开文件、打开文件夹、从文件打开工作区、打开最近的文件
  • 将文件夹添加到工作区、将工作区另存为、复制工作区
  • 保存、另存为、全部保存
  • 共享(导出配置文件)
  • 自动保存、首选项
  • 还原文件、关闭编辑器、关闭窗口
  • 退出

首选项

  • 配置文件
  • cursor设置
  • VS Code设置
  • 扩展
  • 键盘快捷方式
  • 配置代码片段
  • 任务
  • 主题
  • 联机服务设置

编辑

  • 撤销、恢复
  • 剪切、复制、粘贴
  • 查找、替换
  • 在文件中查找、在文件中替换
  • 切换行注释、切换块注释、Emmet展开缩写

选择

  • 全选、扩大选区、缩小选区
  • 向上复制一行、向下复制一行、向上移动一行、向下移动一行、重复选择
  • 在上面添加光标、在下面添加光标、在伟航添加光标、添加下一个匹配项、添加上一个匹配项、选择所有匹配项、选择所有匹配项
  • 切换为“ctrl+单击”进行多光标功能、列选择模式

查看

  • 命令面板、打开视图
  • 外观、编辑器布局
  • 资源管理器、搜索、运行、扩展
  • 问题、输出、调试控制台、终端
  • 自动换行

外观:

  • 全屏、禅模式、居中布局、open browser
  • 菜单栏、主侧边栏、第二侧边栏、状态栏、pannel面板
  • 向右移动主侧栏、面板位置、对齐面板、选项卡栏、编辑器操作位置
  • 缩略图、痕迹导航、粘滞滚动、显示空格、显示控制字符
  • 缩小、放大、恢复

布局:

  • 向上拆分、向下拆分、向左拆分、向右拆分
  • 将编辑器移动到新窗口、将编辑器复制到新窗口
  • 单列、双列、三列、双行、三行、2×2网格、右侧双行、底部双列
  • 翻转布局

转到

  • 返回、前进、上次编辑位置
  • 切换编辑器、切换组
  • 转到文件、转到工作区中的符号
  • 转到定义、转到声明、转到类型定义、转到实现、添加符号到当前对话、转到引用、添加符号到新的对话
  • 转到行/列、转到括号
  • 下一个问题、上一个问题
  • 下一个更改、上一个更改

运行

  • 启动调试、以非调试模式运行、停止调试、重启调试
  • 打开配置、添加配置
  • 逐过程、单步执行、单步停止、继续
  • 切换断点、新建断点
  • 启用所有断点、禁用所有断点、删除所有断点
  • 安装附加调试器

新建断点:

  • 编辑断点、条件断点、内联断点、函数断点、触发的断点、记录点

终端

  • 新建终端、拆分终端
  • 运行任务、运行生成任务、运行活动文件、运行所选文本
  • 显示正在运行的任务、重启正在运行的任务、止任务
  • 配置任务、配置默认生成任务

帮助

  • 显示所有命令、编辑器操场、辅助功能入门
  • 提供反馈
  • 查看许可证
  • 切换开发者工具、打开资源管理器
  • 检查更新
  • 关于

工程栏(左侧边栏)

工程管理

  • 打开文件夹
  • 克隆仓库
  • 创建java项目

搜索查找和替换

  • 搜索、替换、包含的文件、排除的文件

新建文件

新建文件夹

刷新资源管理器

在资源管理器中折叠文件夹

源代码管理

  • 打开包含git仓库的文件夹或从URL克隆

  • 生成提示信息
  • 提交更改

  • 打开更改、放弃更改、暂存更改

  • 查看和排序
  • 拉取、推送、克隆、签出到
  • 提交、更改、拉取/推送、分支、远程、存储、标记、工作树
  • 显示git输出

查看和排序

  • 以列表形式查看
  • 以树形式查看
  • 按路径对更改进行排序
  • 按名称㐉更改进行排序
  • 按状态对更改进行排序

提交:

  • 提交、提交已暂存文件、全部提交、撤销上次提交、中止变基
  • 提交(修改)、提交已暂存文件(修改)、全部提交(修改)
  • 提交(已签收)、提交已暂存文件(已署名)、全部提交(已署名)

更改:

  • 暂存所有更改、取消暂存所有更改、放弃所有更改

拉取/推送:

  • 拉取、拉取(变基)、拉取自
  • 推送、推送到
  • 抓取、抓取(删除)、从所有远程存储库中抓取

分支:

  • 合并、变基分支
  • 创建分支、从现有来源创建新的分支
  • 重命名分支、删除分支、删除远程分支
  • 发布分支

远程:

  • 添加远程存储库、删除远程存储库

存储:

  • 储藏、储藏(包含未跟踪)、储藏暂存
  • 应用最新储藏、应用储藏
  • 弹出最新储藏、弹出储藏
  • 删除储藏、删除所有储藏
  • 查看储藏条目

标记:

  • 创建标记
  • 删除标签
  • 删除远程标记

工作树:

  • 删除工作树

扩展插件管理(应用商店)

  • 在应用商店中搜索扩展插件

更多

搜索栏

按名称搜索文件(追加:转到行,追加@ 转到符号)

代码编辑区

右键已经打开的tab栏

打开侧边预览、ALT打开预览、

打开更改

向右拆分编辑器、[ALT]向下拆分编辑器

终端栏

  • 问题、输出、调试控制台、终端、端口
  • powershell

powershell启动配置文件

  • powershell、git bash、command prompt、javascript 调试终端、split terminal
  • 配置终端设置、选择默认配置文件
  • 运行任务、配置任务

拆分终端

终止终端

更多

  • 滚动到上一条命令、滚动到下一条命令、清除终端、运行活动文件、运行所选文本
  • 转到”最近使用的目录”、运行最近使用的命令

AI对话区

切换agent

新agent对话框

新建agent、[alt]替换agent

显示对话历史

更多

切换agent模式

  • agent 智能体模式
  • plan 计划模式
  • debug 调试模式
  • multitask 多任务模式
  • ask 问答模式

点击切换agent模式,或者在输入框内使用shirt+tab切换模式

切换为plan模式

切换为debug模式

切换为multitask模式

切换为ask模式

切换大模型

  • auto模式,cursor自动根据任务情况自动选择大模型

语音输入

显示隐藏agent侧边栏

设置

  • 搜索设置
  • 通用、vs code 设置
  • 计划和使用
  • 智能体、tab、模型、云端智能体
  • 插件、规则/技能/子智能体、工具和MCP、钩子、索引和文档、网络、beta

通用

  • cursor账户

    • 管理账号和账单
  • PR偏好

    • 首选PR打开位置,选择PR(拉取请求)在网页端、桌面应用和IDE中的打开位置
  • 偏好设置

    • 编辑器设置,配置字体、格式、小地图及更多选项
    • 键盘快捷键,配置键盘快捷键
    • 从VS Code导入设置,从VS Code导入设置、扩展和快捷键绑定
    • 重置不再询问对话框,查看您已隐藏的警告和提示
  • 布局

    • 窗口布局,在agent(代理)和editor(编辑器)模式布局之间切换
    • 对话密度,选择agent工具调用对话中展示的详细程度

  • 状态栏,在窗口底部显示状态栏
  • 审阅控制位置,在顶部导航路径或浮动面板中显示内联差异审阅控制
  • 编译器为空时自动隐藏,当所有编辑器都关闭时,隐藏编辑器区域并最大化聊天面板
  • 以编辑器标签页形式打开聊天,在聊天区域内以编辑器标签页形式显示聊天,代替旧的堆叠视图

通知

  • 系统通知,当agent完成任务或需要关注时显示系统通知
  • 系统托盘图标,在系统托盘中显示cursor
  • 完成提示音,agent回复完成时播放提示音

隐私(默认数据共享,可以切换为隐私模式)

  • 数据共享,您的提示词、编辑及其他使用数据将被cursor存储并用于训练,以改进产品
  • 隐私模式,您的代码数据不会被用于训练或改进产品。代码可能会被存储以提供背景代理等功能。

vs code 设置

计划和使用

查看订阅计划和使用额度

智能体

agent

  • 文本大小,调整对话框文本大小
  • 使用Ctrl+enter提交,启用后,按ctrl+enter提交聊天消息,按enter则插入换行
  • 最大标签页数量,限制同时打开的聊天标签页数量
  • 消息排队,调整agent正在运行时发送消息的默认行为
  • 用量摘要,选择何时在聊天面板底部显示用量摘要
  • agent自动补全,在想agent输入提示词时提供上文相关的建议
  • 自动批准模式切换,允许agent在无需询问的情况下切换模式,例如从agent切换到plan或从agent切换到debug。关闭此选项时,cursor会在切换前询问。

子agent

  • 探索子agent模式,探索子agent用于为主agent进行初步研究

agent审阅

  • 提交后启动agent审阅,每次提交后自动审阅您的更改,检查是否存在问题
  • 在agent审阅中包含子模块,在审阅中包含来自git子模块的更改
  • 在agent审阅中包含未跟踪文件,在审阅中包含未跟踪的文件(尚未添加到git的新文件)
  • 默认方案,在快速分析和更彻底但成本更高的分析之间选择

上下文

  • web搜索工具,允许agent搜索网页以获取相关信息
  • 自动接受网络搜索,由全部运行自动运行模式启用:agent将绕过包括网页搜索在内的工具的审批提示
  • 网页抓取工具,允许agent从url获取内容
  • 层级cursor ignore,将.cursorignore文件应用于所有子目录。更改此设置需要重启cursor
  • 在cursor ignore搜索中忽略符号链接,谨慎使用。在发现 .cursorignore文件时跳过符号链接。仅在您的仓库包含大量符号链接且所有.cursorignore文件在不通过符号链接的情况下均可访问时启用。更改此设置需要重启cursor。

审批与执行

  • 运行模式,选择agent运行工具(如命令执行、MCP和文件写入)的方式;所有命令将在无需审批、分类或沙盒隔离的情况下执行。
  • 浏览器保护,阻止agent自动运行浏览器工具
  • MCP工具保护,阻止agent自动运行MCP工具

应用更改

  • 内联差异,在编辑器中显示内联差异装饰,而不是仅在审阅面板中显示更改
  • 接受时跳转到下一个差异,使用ctrl+Y接受更改时自动跳转到下一个诧异
  • agent完成时自动化格式化

内联编辑与终端

  • 旧版终端工具,在agent模式下使用旧版终端工具,适用于不支持特定shell配置的系统
  • 选中时显示工具栏,选中代码时显示”添加到聊天”和”快速编辑”按钮
  • 自动解析链接,粘贴到快速编辑(ctrl+K)输入框时自动解析链接
  • 主题差异背景,为内联代码差异使用主题背景色
  • 终端提示,在终端中显示ctrl+K的提示
  • 终端ctrl+k预览框,使用预览框代替直接响应流式输出到shell中

语音模式

  • 提交关键词,在语音模式下触发自动提交的自定义关键词。仅允许单个单词(无空格)。标点和大小写将被忽略。
  • PR归属,将拉取记录标记为“使用cursor制作”

git

  • 分支前缀,agent创建新分支时的前缀(例如cursor/、username/)

tab

tab补全

  • cursor tab,基于近期编辑,在光标周围提供上下文感知的多行建议
  • 部分接受,通过ctrl+右箭头健 接受建议的下一个词
  • 注释中的建议,允许tab在注释区域内触发
  • 仅空白建议,为typescript自动导入必要模块
  • python自动导入,启动python自动导入功能
  • 忽略的文件,Cursor Tab 不会在这些 Glob 模式匹配的文件中提供建议

模型

支持主流的最新的模型

支持接入自定义api

云agent

  • 管理设置,连接github/gitlab、管理团队和用户设置,以及配置环境
  • 连接slack,从slack与云代理协作

插件

插件,通过技能(skills)、规则(rules)、智能体(agents)、钩子(hooks)和MCP扩展cursor

支持全部、用户、项目三个级别

规则/技能/子agent

  • 规则、技能、子agent,为agent提供领域特定的知识和工作流

支持全部、用户、项目级别配置

  • 规则,使用规则来引导代理行为,例如强制执行最佳实践或编码标准。规则可以始终应用、按文件路径应用或手动应用

  • 技能(skills),技能时帮助agent完成特定任务的专项能力。agent会在相关时自动调用技能,您也可以在聊天中通过输入 / 手动触发技能。

  • 子agent,为复杂任务创建专门的agent。主agent可以调用子agent来并行处理专项工作。
  • 命令,创建可以在聊天中通过 / 前缀触发的可复用工作流程。使用命令来标准化流程,提高常见任务的执行效率。

工具和MCP

身份认证

  • 等待MCP身份认证,在提示时无限等待以完成身份验证。关闭后30秒后跳过身份验证提示。

浏览器

  • 浏览器自动化,浏览器自动化已禁止
  • 在浏览器标签页中显示localhost连接,在浏览器标签页中自动打开localhost链接
  • 已经安装的MCP服务器

钩子

  • 钩子,钩子允许您在agent执行过程中的特定节点运行自定义脚本,以修改行为、执行策略或添加自定义日志记录

索引和文档

代码库:

  • 代码库索引,为代码库建立索引,以提升上下文理解和知识能力。嵌入向量和元数据存储在云端,但所有代码均存储在本地。
  • 索引新文件夹,自动索引任何文件数少于50000个的新文件夹
  • 忽略.cursorignore中的文件,除.gitignore外,额外排除在索引之外的文件。查看已包含的文件。
  • 为即时grep索引仓库,自动索引仓库以加速grep搜索。所有数据均存储在本地。

文档

  • 添加文档,爬取并索引自定义资源和开发者文档

网络

  • HTTP兼容模式,HTTP/2推荐用于低延迟流式传输。在某些企业代理和VPN环境中,可能需要降低兼容模式。
  • 必须域名,这些域名必须可访问,cursor才能正常工作。请将它们添加到您的防火墙或代理白名单中。
  • 网络诊断,检查与所有cursor服务的网络连通性

切换agents window模式

点击后打开agents window模式的界面

agents window模式

目前主流的模式,cursor、codex、opencode、以及国内很多IDE产品都开始模仿该模式,主要中心从编辑器模式转为AGENT模式,重心在与AI交互而不是编辑代码。

快捷键

快捷键 说明
ctrl+I 打开agent面板
shift+tab 在输入框中切换模式agent、plan、debug、ask

附录

官网

https://cursor.com/[2]

cursor帮助文档

https://cursor.com/cn/docs[3]

引用链接

[1]https://cursor.com/cn

[2]https://cursor.com/

[3]https://cursor.com/cn/docs