Cursor 下载安装与基础操作教程：从登录到完成第一个任务
这篇教程适合第一次使用 Cursor 的人。我们会完成下载、安装、登录、打开项目和第一次使用 Agent，不涉及复杂配置。
如果还不了解 Cursor 的功能和套餐，可以先看：Cursor 是什么？功能、适用人群及免费版和 Pro 版区别。
第一步：从官网下载 Cursor
打开 Cursor 官方下载页，根据电脑系统选择安装包。
常见版本包括：
- macOS：Apple 芯片、Intel 芯片或 Universal；
- Windows：Windows 10/11 的 x64 或 Arm64；
- Linux：AppImage 等版本。
不确定 Mac 使用哪种芯片，可以点击左上角苹果菜单，选择“关于本机”。看到 Apple M 系列芯片时选择 Arm64；较早的 Intel Mac 选择 x64。实在分不清，也可以使用 Universal 版本。
不要从网盘或陌生下载站获取安装包。版本更新较快，官网安装包更容易保持最新。
第二步：安装 Cursor
macOS 安装
- 打开下载的安装文件；
- 将 Cursor 拖入“应用程序”文件夹；
- 在“应用程序”中打开 Cursor；
- 如果系统出现安全提示，先确认文件来自 Cursor 官网。
Windows 安装
- 双击下载的安装程序；
- 根据提示完成安装；
- 从开始菜单打开 Cursor。
Linux 安装
Linux 的安装方式取决于下载的文件类型。使用 AppImage 时，通常需要先给文件执行权限，再运行文件。具体命令以官方下载页的当前说明为准。
第三步：完成首次设置
第一次打开 Cursor 时，会出现简单的引导页面。你可以设置：
- 常用的键盘快捷键；
- 编辑器主题；
- 终端偏好；
- 是否导入原编辑器配置。
Cursor 官方支持直接导入 VS Code 设置。已经使用 VS Code 的人，可以导入主题、快捷键和部分扩展，减少重新配置的时间。
以后想重新运行引导，可以打开命令面板：
- macOS：
Cmd + Shift + P - Windows / Linux：
Ctrl + Shift + P
然后搜索：
Cursor: Start Onboarding
第四步：注册和登录
Cursor 不登录也能作为普通编辑器使用，但 AI 功能需要账号。
打开 Cursor Settings，进入账号区域，按提示在浏览器中登录或注册。浏览器授权完成后再返回 Cursor。
如果浏览器显示登录成功，但编辑器没有反应：
- 等待几秒，不要连续点击登录；
- 回到 Cursor 查看账号状态；
- 关闭代理规则中的异常分流；
- 重启 Cursor 后再试；
- 仍然失败时，打开 Cursor 状态页 检查认证服务。
第五步：认识 Cursor 界面
Cursor 的界面和 VS Code 很接近，新手先认识以下区域：
文件区
左侧文件区显示当前项目的文件夹和文件。点击文件即可打开编辑。不要一开始就打开整个用户目录，选择具体项目文件夹更安全，也能减少索引时间。
编辑区
中间是代码编辑区。打开多个文件后，可以通过顶部标签切换。
Agent 侧边栏
Agent 通常可以通过 Ctrl + I 打开。这里用于提问、选择模型和安排项目任务。
Cursor 官方文档中的主要模式包括：
- Agent：搜索项目、修改多个文件和运行命令；
- Ask：只读取和分析项目，适合先了解代码；
- Custom：按需要配置工具和规则。
界面名称可能随版本调整。如果只想让 Cursor 解释代码，先用 Ask；确认修改目标后再切到 Agent。
终端
终端用于启动项目、安装依赖和运行测试。可以从顶部菜单打开，也可以使用常见快捷键 Ctrl + `。
修改记录
Agent 修改文件后，要查看 Diff。新增内容和删除内容会用不同颜色显示。不要跳过这一步，尤其是涉及配置、数据库和登录功能时。
第六步：打开第一个项目
点击“Open Folder”或菜单中的“打开文件夹”，选择一个项目目录。
项目打开后，Cursor 会建立代码库索引。小项目通常较快，大项目可能需要几分钟。可以在 Cursor Settings 的 Indexing & Docs 中查看进度。
索引没有完成时，项目问答可能漏掉相关文件。遇到回答明显不完整，可以等索引完成后再试。
第七步：尝试基础 AI 操作
让 Cursor 解释代码
打开 Ask 模式，输入：
请先阅读这个项目，不要修改文件。
用中文说明它的主要功能、启动方式和核心目录。
这是新手最安全的第一步。先看 Cursor 能否正确理解项目，再安排修改。
修改一小段代码
选中一段代码，说明具体要求：
给这段函数增加输入为空时的处理，不要改变原来的返回格式。
修改后检查 Diff，再运行相关功能。
让 Agent 完成一个小任务
可以从文案或样式修改开始：
把首页按钮文字改为“免费开始”，保持现有样式。
修改后告诉我改了哪个文件，不要改其他内容。
范围越明确，结果越容易检查。第一次不要直接让 Agent 重构整个项目。
第八步：运行项目并检查结果
不同项目的启动命令不同。可以先问：
请查看项目说明和 package.json，告诉我正确的启动命令，先不要执行。
确认后再让 Agent 运行。网页项目启动后，打开本地地址检查页面；代码任务完成后，运行测试或构建命令。
AI 说“已完成”不代表任务真的可用。至少检查：
- 修改差异是否符合要求；
- 项目能否正常启动；
- 原有功能是否受到影响；
- 测试或构建是否通过。
新手容易遇到的问题
扩展装得越多越好吗？
不是。先保留项目需要的扩展。出现卡顿或界面异常时，可以临时使用 cursor --disable-extensions 启动，排查是否由扩展引起。
可以让 Agent 自动运行所有命令吗？
可以配置，但新手不建议一开始开启。安装依赖、删除文件、修改数据库和部署都可能产生实际影响，先逐条确认更稳妥。
Cursor 一直在索引怎么办？
先确认项目中是否包含大量生成文件、依赖目录或超大文件。也可以在 Settings 的 Indexing & Docs 查看状态。网络不稳定时，部分在线功能也可能受到影响。
登录或 Agent 一直 Loading 怎么办？
先查看 Cursor 状态页，再运行 Cursor Settings > Network > Run Diagnostics。完整排查方法见：Cursor 无法登录、一直 Loading 或 Connecting 怎么办。
下一步
完成第一次任务后，可以继续比较不同 AI 编程工具：Cursor 和 Codex 哪个更适合你。
如果你经常需要访问 Cursor、GitHub、海外模型和开发文档，可以考虑使用 Nexus VPN。使用前请确认符合所在地法律和相关平台条款。
Nexus VPN 提供工作时段流量优惠：每日 9:00-18:00 产生的流量按 40% 计算，用 1GB 只扣 0.4GB。详情见优惠页。
访问 Nexus VPN：https://nexusvpn.ltd