Skip to content

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. 下载安装与登录 ​

  1. 只从官网下载:打开 cursor.com/download,官方提供:
    • macOS(Apple 芯片、Intel 或通用版);
    • Windows(x64 与 ARM64,分系统级和用户级安装);
    • Linux(.deb 与 RPM,x64 与 ARM64)。
  2. 安装并打开,按首次启动向导操作。如果你之前用 VS Code,可以选择导入原有设置、快捷键和扩展。
  3. 登录账号:按提示在浏览器中注册或登录 Cursor 账号,完成后回到编辑器。
  4. 打开项目文件夹:通过文件菜单打开一个练习项目。

如果想在终端里使用 Cursor 的命令行工具,官网下载页给出的安装命令是:

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

登录卡住或 AI 功能无响应

编辑器能打开,但登录页或 AI 请求一直转圈,多半是 Cursor 这个桌面程序没有走代理。见 浏览器能访问,为什么应用程序连接失败。

5. 第一个任务 ​

在一个已经用 Git 管理的练习项目里操作(创建方法见 AI 编程工具入门)。

  1. 打开 Agent:macOS 按 Cmd+I(Windows / Linux 通常为 Ctrl+I)在侧边栏打开 Agent。

  2. 先了解项目:

    text
    这个项目是做什么的?目录结构是怎样的?我应该先看哪个文件?
  3. 提一个小改动:

    text
    给联系页面的表单加上输入检查:邮箱格式不对时,在输入框下方显示红色提示。
    先列出计划,等我确认后再修改。

    较大的需求可以切换到计划模式,让它先写计划。

  4. 逐个查看改动:Agent 会在编辑器中显示每个文件的差异,你可以逐处接受或拒绝。

  5. 验证并提交:运行项目确认效果,再用 Git 提交。改坏了可以回到检查点,或用 Git 回退。

6. 常用技巧与提示词示例 ​

  • 用规则固定要求:在 .cursor/rules 中写入“所有注释用中文”“改完后运行测试”等,省去每次重复。

  • 指定相关文件:在对话中引用具体文件,Agent 找得更准,也更省额度。

  • 任务进行中补充要求:Agent 工作时按 Enter 可以把新消息排队,按 Cmd+Enter 立即发送。

  • 善用检查点:试验性的改动不满意就回退到检查点,再换个说法重来。

  • 一次只做一件事:

    text
    只修改 src/components/Header 这个组件:把导航菜单在手机宽度下改成折叠按钮。
    不要改动其他文件。

更多实战做法见 用 AI 做一个网页:从需求描述到上线 和 用 AI 读懂和修改已有项目代码。

7. 和同类工具怎么选 ​

对比怎么选
Cursor vs GitHub CopilotCopilot 是装在现有编辑器里的助手,支持编辑器更多;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 生态,大部分扩展可以使用,个别扩展以实际为准

可用性以服务方公布的支持地区为准。

相关阅读 ​