想用 AI 写代码，绕不开三个现实问题：Cursor 好用但要付费、界面是英文；VS Code 插件东拼西凑，配一圈才能开工；在线大模型聊天框只能给代码片段，改一个小功能要来回复制粘贴。Cursor 就是后一种工具：它由 Anysphere 公司开发，基于 VS Code 构建，保留了 VS Code 的全部功能和插件生态，同时把 AI 对话和 Agent 深度集成进了编辑器。这篇把从下载安装、登录、导入旧配置，到第一次用 Agent 改出一个能跑的网页的完整流程走一遍，照着做就能复现。本文按 2026 年 11 月初的 Cursor 3.x 版本界面写，菜单位置如有微调，以你手头的版本为准。

一、Cursor 是什么，先认清四个用法

装之前先搞清 Cursor 的四个用法，之后 90% 的操作都在这里，用错了入口会觉得它“不好用”，其实是没找对地方：

1. Tab 补全：写代码时按 Tab 接受 AI 给出的整行甚至整段补全，适合写样板代码和重复逻辑；

2. 行内改代码：选中一段代码按 Ctrl+K（Mac 上是 Cmd+K），在弹出的小框里用中文说想怎么改，适合小修小补；

3. 对话与 Agent：按 Ctrl+I 或 Ctrl+L（Mac 上是 Cmd+I 或 Cmd+L）打开侧边对话面板，Ask 模式只问不改，Agent 模式会自己读项目、改多个文件并给出 diff 等你确认；

4. Agent 命令行：终端里也能跑 Cursor 的 Agent，适合已经习惯在终端里干活的人，后面会讲安装方法。

老教程里提到的 Composer 模式、Inline Edit 独立入口，在新版里已经合并进了 Agent 和行内改，不用再去找旧入口。版本更新很快，界面细节以官方文档为准，核心流程这几年一直没变。

二、下载安装：三种装法，按系统选

第一步，打开 cursor.com/download，按自己的系统选安装包：macOS 要求 12.0 及以上，分 Apple Silicon 和 Intel 两个包，对照“关于本机”里的芯片选；Windows 要求 10 及以上，下载 .exe 安装程序；Linux 提供 apt 和 dnf 软件源安装包，也有便携版 AppImage。

第二步，运行安装程序一路点下一步即可。macOS 把 Cursor 拖进“应用程序”文件夹；Windows 按向导装完就能从开始菜单启动；Linux 用包管理器装的好处是以后更新跟着系统走，不用手动下新包。

第三步（推荐，包管理器装法），习惯用命令行的可以直接用包管理器装，下载过程有哈希校验，损坏的安装包会直接装不上，比手动下载更稳：

brew install --cask cursor
winget install Anysphere.Cursor

上面第一条是 macOS 的 Homebrew，第二条是 Windows 的 winget。装完打开新终端跑一下验证：

cursor --version

能打出版本号就说明装好了。如果提示找不到命令，先在 Cursor 里按 Ctrl+Shift+P（Mac 上是 Cmd+Shift+P）打开命令面板，搜“shell command”，运行安装 cursor 命令到 PATH 的那一项，再关掉所有终端重开一个。

三、登录账号与套餐：先用免费版试手感

第一次打开 Cursor，会提示登录账号。没有账号就按提示注册一个，邮箱注册即可。注意一个细节：登录过程可能会跳转到一个带 Grok 或 xAI 标识的联合登录页，这是 Cursor 当前的登录流程，页面本身是官方的，按提示完成登录就行，不用慌。

登录后会让你选套餐。Cursor 提供免费版，不用绑卡就能体验核心功能；付费档按月计费，额度越高、能用的模型和 Agent 次数越多。Cursor 这两年调过几次价，本文不写死具体数字，选之前先看一眼官网定价页 cursor.com/pricing，按自己的用量选。建议的顺序是：先用免费版把下面第四、第五节的流程完整走一遍，确认 Agent 的工作方式适合你，再决定要不要升级。

登录完成后，首次启动还会问你要不要从 VS Code 导入配置：扩展、主题、设置、快捷键可以一键带过来。如果当时点了跳过，后面随时能在设置里补：按 Ctrl+Shift+J（Mac 上是 Cmd+Shift+J）打开 Cursor 设置，进 General → Account → VS Code Import，点导入就行。导入后建议对照检查一遍常用扩展在不在，个别扩展可能因为版本差异没带过来，缺了再手动装。

四、开工前的三件事：建练习项目、开隐私模式、定规则

正式让 Agent 动手之前，先把三件事做完，能省掉后面大部分麻烦。

第一件，新建一个练习文件夹，不要直接在正式项目上练手。在电脑上新建空文件夹，起名 hello-cursor，在 Cursor 里用“打开文件夹”把它打开。然后在 Cursor 自带的终端里给它存一个起点：

git init
git add .
git commit -m "init"

这一步的意义是：Agent 改错了随时能用 git 回滚。所有 AI 改代码的操作，都应该先有这条退路。

第二件，看一眼隐私模式。设置 General 里有 Privacy Mode（隐私模式）开关，打开后你的代码不会被用于训练。公司项目或私人代码，先开隐私模式再开工，养成习惯比事后补救强。

第三件，定规则文件。Cursor 支持在项目里放规则文件，告诉 Agent 每次都按你的规矩写代码：项目根目录建 .cursor/rules 目录，里面放 .mdc 后缀的规则文件，比如规定“回复用中文”“新功能先写测试再写实现”。规则分生效范围，常用的有始终生效、按需引用两种写法，具体语法和四档生效类型之前写过一篇专门讲 Cursor Rules 的文章，这里只提醒一句：规则文件是让 Agent 长期稳定的关键，项目稍微大一点就值得写一份。

五、第一次实战：让 Agent 做一个番茄钟网页

光看不练等于没学。下面让 Agent 从零做一个番茄钟网页，全程只需要一句话需求，重点练“提需求—审 diff—跑起来验收”这个闭环。

第一步，确认当前打开的是刚建的空文件夹 hello-cursor，左侧没有多余文件。

第二步，按 Ctrl+L 打开对话面板，确认模式是 Agent（不是 Ask，Ask 模式只回答不改文件）。在输入框里写清楚需求，需求写得越具体，返工越少，可以直接抄这句：

“做一个番茄钟网页：页面中间一个大号倒计时，默认 25 分钟，有开始、暂停、重置三个按钮，倒计时结束弹出提示；顶部加一行小字说明番茄工作法；整体深色简洁风格，单个 HTML 文件实现。”

第三步，等 Agent 跑完，它会列出新建或修改的文件和每一处改动的 diff。别急着点“全部接受”，逐条看一遍 diff：文件是不是新建的 index.html、有没有多建不需要的文件、倒计时的逻辑是不是 25 分钟换算成秒再减。有问题的单条拒绝，没问题的接受。

第四步，验收。直接用浏览器打开生成的 HTML 文件，验收标准就三条：倒计时数字正常走、三个按钮都能点、时间到 0 有提示。三条都过，这一轮就算成了。

第五步，换行内改练一次小修改。选中倒计时那行代码，按 Ctrl+K 输入“把默认时间改成 15 分钟”，看它只改这一处、不动其他代码。这一步是为以后日常改 Bug 练手感：小改动用行内改，大重构再开 Agent。

六、终端里也能用：装一个 Agent 命令行

如果平时主要在终端里干活，可以再装一个 Cursor 的 Agent 命令行，编辑器不用开也能让 Agent 改代码。终端里运行：

curl https://cursor.com/install -fsS | bash

装完命令是 agent，在项目目录里直接输入 agent 就能开始对话，工作方式和编辑器里的 Agent 一样：读项目、改文件、给 diff 等你确认。命令行版和编辑器版共用同一个账号登录状态，装完先跑 agent --help 看一眼可用参数再上手。

七、踩坑提醒：这七个地方最容易翻车

第一个坑，Agent 改错了没法回退。根源是没有先 git commit 存基线，上面第四节第一件事就是解药。每次让 Agent 动大手术之前，先 commit 一次，改崩了直接回滚，比逐条撤销快得多。

第二个坑，把密钥和密码粘进对话。API Key、数据库密码、Token 一律不要出现在聊天框里，对话记录可能被留存。需要配密钥的地方用环境变量或配置文件，配置文件记得加进 .gitignore。

第三个坑，命令审批关了。Agent 有时会提议运行命令，默认会先问你再执行。保持这个审批开关开着，别为了图省事改成自动放行，尤其是在正式项目里，一条删文件或改配置的命令放错了代价很大。

第四个坑，装扩展不看发布者。2026 年 10 月 29 日，Cursor 官方曾警告 Marketplace 里出现冒充 Anthropic.claude-code 的恶意扩展（版本号 2.1.312 和 2.1.313）。装任何扩展之前先核对发布者名字，认准官方或口碑好的作者，名字相近、版本可疑的一律别装。

第五个坑，免费额度当无限用。免费版的 Agent 次数和高级模型调用是有限额的，复杂任务先拿小需求试手感，摸清一次任务大概花多少额度再上大活儿，别一上来就让 Agent 啃整个项目。

第六个坑，需求一句话堆大项目。Agent 能自主跑全流程不等于一次就能出完美结果，需求越大返工概率越高。正确姿势是先做最小可用版本跑通，再一轮一轮加功能，每轮验收通过再继续。

第七个坑，照着旧教程找旧入口。Cursor 界面更新快，Composer 之类的旧模式名已经消失，菜单位置也常有微调。按本文流程走不通时，先看一眼官方文档或更新日志，别硬套旧截图。

小结

Cursor 适合三类人：已经在用 VS Code 的开发者，迁移成本几乎为零，扩展和配置一键带过来；想体验 Agent 式编程的人，Tab 补全、行内改、Agent 对话三层入口由浅入深；经常改别人项目或接手老代码的人，Agent 先读项目再动手，比自己翻文件快得多。它的打法很明确：小改动用 Tab 和 Ctrl+K，大重构交给 Agent，每次动手前先 git 存基线、开隐私模式，改完逐条审 diff 再接受。按上面五步走一遍，半小时内就能跑出第一个能用的网页，剩下的就是在自己的项目里反复练手感了。