博客 · Cursor 使用指南 · 发布
Cursor 怎么开始用:下载、登录与第一个项目
按 Cursor 官方快速入门整理下载、登录与第一个项目的顺序:各系统该取哪种安装包、登录后要确认什么、用 Cmd/Ctrl+I 打开 Agent 先解释代码库,再做一个小改动、看 diff 并运行项目已有检查;任务跨多个文件、需要先做调研或需要你先批准时,用 Plan Mode。文中给出下载对照表、Plan Mode 的适用判断与卡住时的五步排查,并说明不建议使用第三方打包的安装包。
第一次用 Cursor,按官方快速入门的顺序走,步骤是清楚的:从下载页取对应系统的安装包,打开应用登录,选一个文件夹,用 Cmd+I(macOS)或 Ctrl+I(Windows、Linux)打开 Agent(智能体,能自己读项目文件、改代码的助手),先让它解释这个代码库,再做一个小改动,最后看 diff(差异视图,逐行标出新增、删除与修改的行)并运行项目原本在用的检查(Cursor 快速入门)。第一次不必从重写整个模块开始,官方举的低风险例子是改文案、修小界面这类改动;跨多个文件、需要先做调研,或需要你先批准再写代码时,适合先按 Shift+Tab 切到 Plan Mode(计划模式)拿一份计划。
一、下载:先按系统对一遍安装包
官方把下载清单按系统分开,差别不只在安装包后缀:
| 系统 | 官方写明的版本要求 | 安装包形式 | 页面另注明的信息 |
|---|---|---|---|
| macOS | macOS 12(Monterey)及以上 | 原生安装包(.dmg) | Apple Silicon 与 Intel 都支持 |
| Windows | Windows 10 及以上 | 原生安装包(.exe) | 该页未另列其他要求 |
| Debian / Ubuntu | 该页未另列 | apt 仓库 | 页面标注为推荐方式 |
| RHEL / Fedora | 该页未另列 | dnf 仓库 | 用官方给出的仓库文件安装 |
| Linux 便携版 | 该页未另列 | AppImage | 先赋予执行权限再运行 |
原生安装包(.dmg、.exe)是下载后双击、按系统提示装好的常规方式,不经过软件商店,也不需要额外的软件源。macOS 这一行只列了一个 .dmg,并注明两种芯片都支持,所以不必再挑芯片版本。
Linux 那三行才需要做选择。官方写明 apt 与 yum 包优先于 AppImage,理由是它们提供桌面图标、自动更新与 CLI(命令行工具,能在终端里直接输入命令调用 Cursor)。AppImage 按页面标注是便携版,下载后先用 chmod +x 加上可执行权限,再直接运行;官方把自动更新这一条写在 apt 与 yum 名下,没有写给 AppImage。
获取渠道也按这个分法:桌面安装包从 cursor.com 的下载页取,Linux 的仓库地址在 downloads.cursor.com(Cursor 快速入门)。论坛、网盘或教程附件里的安装包无法核对来源与改动,本篇不建议使用第三方打包的版本。
二、登录:官方只写一步,你要确认两件事
快速入门对登录只写到「打开应用并登录」这一步,然后就是选一个文件夹、从一个小任务开始。这一页没有再展开账号类型、套餐或计费;文档首页把模型与定价收在 Models & Pricing 一栏,账号与账单问题则指向官方 Support 入口(Cursor 文档)。
所以第一次登录只需要确认两件事:能进到应用主界面,能选中一个本地文件夹。这两件都成立,就可以往下走;卡在这一步,先回官方下载页核对系统版本,不建议改用第三方打包的安装包。
界面和你看到的教程截图对不上时,文档首页另有 Changelog(更新记录)入口,先去核对最近改了什么,再判断是不是自己点错了。
三、第一个项目:先让它讲清楚,再让它动手
选好文件夹后,用 Cmd+I 或 Ctrl+I 打开 Agent。官方建议的第一个请求是让它解释这个代码库:指出主要入口、关键模块,以及动手改之前应该先读哪些文件。它会搜索仓库、读取相关文件,再把项目各部分怎么拼起来总结给你。
有一个前提不能跳过:Agent 读的是你选中的那个文件夹。目录选错,它讲的就成了另一个项目,后面的改动也会落到错误的位置。所以第一步不是急着写提示,而是先看项目栏里的目录名对不对。
提示用中文写就行,把范围、要它输出什么说清楚。官方给的两个示例都是先说明要它做什么,其中第二个还要求它说明取舍、并等你选择之后再动手;下面这个示例另外加了一句「先不要改动文件」,你可以按需要保留(假设示范,不是官方原话):
先不要改动任何文件,通读这个项目,告诉我入口在哪、核心模块有哪几个、改代码之前必须先读哪几个文件,无法确认的地方标出来。
四、第一个改动:小、能核对、能回退
看懂结构之后,让它提几个小而安全的改进并说明各自的取舍,你挑一个再让它动手;如果你已经知道要什么,就直接描述想要的结果。官方举的低风险例子是改文案、修小的界面问题——范围小,出问题时也好回退。
它动手时你会看到 diff,逐行标出新增、删除和修改。官方在这一步的要求很具体:等它做完,先看 diff,再让它运行项目本来就在用的检查。这类检查通常分四种,含义不一样:
- 测试:跑一遍已有用例,看有没有改坏;
- 类型检查:看变量和数据的类型对不对得上;
- lint:代码规范检查,管格式和易错写法;
- 本地构建:看项目能不能正常打包或启动。
这一步把「看起来改对了」变成「跑过一遍」。diff 让你看它到底动了哪几行,检查告诉你有没有碰坏别的地方。两样都过,再谈下一个任务;只过一样,就先让它解释没过的原因,别急着加需求。
五、任务变大:先切 Plan Mode 拿计划
官方写明 Plan Mode 适合三种任务:跨多个文件、需要先做调研、或者要你先批准再写代码。切换方式是在 Agent 输入框按 Shift+Tab。进入后它不会马上写代码,而是按顺序走:调研代码库找出相关文件,就需求提问,给出详细的实施计划,等你批准后再动手。
| 你手上的任务 | 建议模式 | 你会看到什么 | 你要做什么 |
|---|---|---|---|
| 改一句文案、调一处样式 | 直接改 | 一份 diff | 看 diff、跑项目已有的检查 |
| 涉及多个文件的新功能或重构 | Plan Mode | 相关文件、提问、实施计划 | 回答提问、批准计划 |
| 需求自己也说不清 | Plan Mode | 它反过来问你 | 先把需求答清楚再批准 |
最直接的判断是这次改动会不会同时动到好几处;如果任务还需要先做调研,或者需要你先批准再写代码,也同样适合用 Plan Mode。
六、卡住时按这个顺序排查
按顺序走,每一步都能得到一个明确答案:
- 装不上:先核对系统版本(macOS 12 起、Windows 10 起);Linux 优先用 apt 或 dnf 仓库;AppImage 要先赋予执行权限才能运行。
- 打不开 Agent:macOS 用 Cmd+I,Windows 与 Linux 用 Ctrl+I。
- 改完不确定对不对:打开 diff 逐行看,再让它运行项目已有的测试、类型检查、lint 或本地构建。
- 越改越乱:先停手,切到 Plan Mode 要一份计划,批准之后再让它动手。
- 账号、计费以及文档没覆盖的问题:走文档首页的 Models & Pricing 与 Support 两个入口。
顺序的道理是:装错、按错键这类原因自己能确认,先排除;账号与账单要官方入口才能查,放在后面。
七、熟悉之后,把反复交代的事写成规则
快速入门的下一步里列了 Rules:为项目写长期生效的指令,不必每次重复说明。这不是上手必需的一步,等你在同一个项目里反复交代同一件事时再写。文档首页把自定义相关内容收在 Customize(自定义)一栏,可连接的工作流列了 GitHub、GitLab、Azure DevOps、Bitbucket、JetBrains、Slack、Linear 等,用到哪一项再去看对应页(Cursor 文档)。
八、想比较付费档位时,再看这里
Cursor 的下载、登录和基本用法到这里就齐了。本篇只回答上手问题,不比较价格;账号与计费问题按文档首页指向的官方 Support 处理。
本站是第三方代充服务,与 OpenAI 无关联,只处理 ChatGPT 会员相关订单,Cursor 不在服务范围内(充值服务条款)。如果你同时想按用量比较 ChatGPT 档位、判断要不要付费,可以看订阅费用总览;在售档位与价格见 ChatGPT 充值套餐,每次只充 1 个月、不自动扣费,人民币成交价与 OpenAI 官方美元定价不是同一口径,不宜直接换算比较。