外观
Cursor 入门教程:安装、登录与第一个任务
一句话介绍:Cursor 是一款内置 AI 的代码编辑器,外观和操作方式与 VS Code 相近;你可以边写代码边接受 AI 补全,也可以在侧边栏让 Agent 读懂项目、修改多个文件并运行命令。
截图待补充
上线前补充实际操作截图并核验软件版本。界面名称以官网英文界面为准,可能随版本调整。
CCursor
内置 AI 的代码编辑器,支持补全与 Agent 代理
- 官方入口
- cursor.com
- 收费方式
- 免费版 + 付费订阅
- 适合人群
- 习惯图形界面编辑器的开发者
- 教程
- Cursor 介绍与教程
资料核验:2026-10-09
编辑器、Git、练习项目等通用准备见 AI 编程工具入门:开始使用前需要准备什么,本页只讲 Cursor 本身。
1. 主要功能
| 功能 | 说明 |
|---|---|
| 代码补全 | 写代码时预测你接下来要写的内容,按 Tab 接受 |
| Agent | 在侧边栏用自然语言描述任务,Agent 会搜索文件、编辑代码、运行终端命令,必要时向你提问 |
| 计划模式(Plan Mode) | 先拆解需求、列出计划,确认后再动手,适合较大的功能 |
| 检查点(Checkpoints) | Agent 做较大改动前自动保存快照,可以回到之前的状态,不影响 Git 历史 |
| 规则(Rules) | 在 .cursor/rules 中写项目规范,Agent 会按规则工作 |
| 多模型可选 | 可在 Anthropic、OpenAI、Google 等多家公司的模型之间切换 |
| 扩展能力 | 支持 MCP、技能、钩子、插件;可连接 GitHub、GitLab、Slack 等 |
| 其他形态 | 命令行工具(CLI)、云端代理、代码审查工具 Bugbot |
2. 适合谁 / 不适合谁
适合:
- 习惯图形界面、希望在一个编辑器里完成全部工作的人;
- 正在用 VS Code、想无痛迁移的人(可以导入原有设置);
- 想在不同 AI 模型之间切换比较的人。
不太适合:
- 必须使用 JetBrains、Xcode 等其他编辑器的人——可以看 GitHub Copilot;
- 主要在服务器终端里工作的人——Claude Code 或 Codex 更顺手(Cursor 也有 CLI)。
3. 收费方式
官网定价页列出的方案类型:
| 方案 | 说明 |
|---|---|
| Hobby(免费) | 不需要绑定银行卡,Agent 请求次数有限,适合试用 |
| 个人付费方案 | 更高的 Agent 用量、可用更多前沿模型、云端代理、MCP / 技能 / 钩子等 |
| 团队方案 | 增加集中计费、团队共享、使用统计、隐私模式、单点登录等 |
| 企业方案 | 定制计费、权限管理、审计日志等,需联系销售 |
具体价格和各档用量以 官方定价页 为准。先用免费版做几次真实任务再决定,详见 免费 AI 工具和付费订阅怎么选。
4. 下载安装与登录
- 只从官网下载:打开
cursor.com/download,官方提供:- macOS(Apple 芯片、Intel 或通用版);
- Windows(x64 与 ARM64,分系统级和用户级安装);
- Linux(.deb 与 RPM,x64 与 ARM64)。
- 安装并打开,按首次启动向导操作。如果你之前用 VS Code,可以选择导入原有设置、快捷键和扩展。
- 登录账号:按提示在浏览器中注册或登录 Cursor 账号,完成后回到编辑器。
- 打开项目文件夹:通过文件菜单打开一个练习项目。
如果想在终端里使用 Cursor 的命令行工具,官网下载页给出的安装命令是:
bash
curl https://cursor.com/install -fsS | bash登录卡住或 AI 功能无响应
编辑器能打开,但登录页或 AI 请求一直转圈,多半是 Cursor 这个桌面程序没有走代理。见 浏览器能访问,为什么应用程序连接失败。
5. 第一个任务
在一个已经用 Git 管理的练习项目里操作(创建方法见 AI 编程工具入门)。
打开 Agent:macOS 按
Cmd+I(Windows / Linux 通常为Ctrl+I)在侧边栏打开 Agent。先了解项目:
text这个项目是做什么的?目录结构是怎样的?我应该先看哪个文件?提一个小改动:
text给联系页面的表单加上输入检查:邮箱格式不对时,在输入框下方显示红色提示。 先列出计划,等我确认后再修改。较大的需求可以切换到计划模式,让它先写计划。
逐个查看改动:Agent 会在编辑器中显示每个文件的差异,你可以逐处接受或拒绝。
验证并提交:运行项目确认效果,再用 Git 提交。改坏了可以回到检查点,或用 Git 回退。
6. 常用技巧与提示词示例
用规则固定要求:在
.cursor/rules中写入“所有注释用中文”“改完后运行测试”等,省去每次重复。指定相关文件:在对话中引用具体文件,Agent 找得更准,也更省额度。
任务进行中补充要求:Agent 工作时按 Enter 可以把新消息排队,按
Cmd+Enter立即发送。善用检查点:试验性的改动不满意就回退到检查点,再换个说法重来。
一次只做一件事:
text只修改 src/components/Header 这个组件:把导航菜单在手机宽度下改成折叠按钮。 不要改动其他文件。
更多实战做法见 用 AI 做一个网页:从需求描述到上线 和 用 AI 读懂和修改已有项目代码。
7. 和同类工具怎么选
| 对比 | 怎么选 |
|---|---|
| Cursor vs GitHub Copilot | Copilot 是装在现有编辑器里的助手,支持编辑器更多;Cursor 是独立编辑器,AI 功能整合更深 |
| Cursor vs Claude Code / Codex | 后两者以终端为主,也能装进 VS Code(以及 Cursor)里使用;喜欢图形界面、想看清每处改动选 Cursor |
不少人会组合使用:在 Cursor 里写代码,同时在它的终端中运行 Claude Code 或 Codex。总体对照见 AI 编程工具入门 和 AI 导航:AI 编程与建站工具。
8. 常见问题
| 问题 | 处理 |
|---|---|
| 登录后 AI 请求失败、模型列表为空 | 按 AI 工具报错或无法访问怎么排查 检查网络,必要时开启 TUN 模式,见 代理客户端 TUN 模式怎么开 |
| 免费额度很快用完 | 免费版 Agent 次数有限;缩小任务范围、指定文件能节省用量,额度规则见 AI 工具的免费额度与使用限制 |
| 代码会被拿去训练吗 | 官网提供隐私相关设置(团队方案含隐私模式),处理公司代码前先阅读官方隐私说明 |
| VS Code 扩展能用吗 | Cursor 基于 VS Code 生态,大部分扩展可以使用,个别扩展以实际为准 |
可用性以服务方公布的支持地区为准。