第二章 五分钟快速上手

一、动手前的 3 分钟准备

我们先确保你不会在动手之后才发现"哎呀少了什么东西"。

1.1 你需要这些东西

不需要的东西：

• 不需要装 Node.js、Python、Git。
• 不需要懂任何编程语言。
• 不需要会用终端（虽然装完后我们会教你打开它，但本章不需要）。
• 不需要梯子（cursor.com 在国内可以直接打开和下载）。
• 不需要付费——Hobby 免费档就够本章用。

1.2 这一章你会得到什么

• 装好 Cursor，能打开它。
• 把界面切成中文（默认是英文）。
• 注册一个免费账号。
• 用大白话做出"你的个人简介网页"，文件就在你电脑上。
• 学会三个最基础的快捷键：Cmd+L、Cmd+I、Cmd+K。
• 知道遇到 5 大首次报错怎么办。

预计耗时：45 分钟（不算下载时间）。

二、下载与安装

2.1 macOS 安装

步骤 1：打开浏览器，访问 https://cursor.com/download。

步骤 2：网站会自动识别你的系统，给你一个大大的「Download for Mac」按钮。点它。

如果你的 Mac 是 M 系列芯片（M1 / M2 / M3 / M4），下载的是 arm64 版本，会更快。 如果你的 Mac 是 Intel 芯片（2020 年之前的 Mac），下载的是 x64 版本。 Cursor 会自动选对版本，不用你操心。

步骤 3：下载完成后，双击下载好的 Cursor.dmg 文件。

步骤 4：在弹出的窗口里，把左边的「Cursor」图标拖到右边的「Applications」（应用程序）文件夹里。等待几秒拷贝完成。

步骤 5：打开「访达」→ 「应用程序」，找到「Cursor」，双击打开。

如果系统提示"无法验证 Cursor 是来自身份不明的开发者"，请按以下步骤：

1. 打开「系统设置」→「隐私与安全性」。
2. 滚动到底部，找到一行红色提示"Cursor 已被阻止"。
3. 点旁边的「仍要打开」按钮。
4. 输入你的开机密码确认。

2.2 Windows 安装

步骤 1：访问 https://cursor.com/download，点「Download for Windows」。

步骤 2：下载到的是 Cursor Setup x.x.x.exe，双击运行。

步骤 3：安装向导默认一路点「下一步」即可。

• 安装路径：默认即可（一般是 C:\Users\你的名字\AppData\Local\Programs\cursor）。
• 是否创建桌面快捷方式：建议勾选。

步骤 4：安装完成后，桌面会出现「Cursor」图标，双击打开。

如果 Windows Defender 弹窗"Windows 已保护你的电脑"：

1. 点小字"更多信息"。
2. 点出现的「仍要运行」按钮。 这是因为 Cursor 是国外软件，Windows 默认警惕第三方应用。

2.3 Linux 安装

步骤 1：访问 https://cursor.com/download，下载 .AppImage 文件。

步骤 2：在终端里执行：

chmod +x ~/Downloads/Cursor-*.AppImage
~/Downloads/Cursor-*.AppImage

步骤 3：第一次运行会自动注册到系统启动菜单，之后可以从菜单里直接打开。

Linux 用户建议看 官方 Linux 文档 处理 FUSE 等依赖问题。

2.4 国内下载慢怎么办

cursor.com 在国内可以直连，但是下载速度有时会慢。如果你下到一半很慢：

• 方法 1：用浏览器自带"暂停 / 继续"功能多试几次。
• 方法 2：直接去 GitHub Releases 找镜像（搜索"cursor download mirror"）。
• 方法 3：用迅雷下载，迅雷会自动加速。

三、第一次启动

3.1 注册账号

第一次打开 Cursor，会出现"欢迎"界面，包含几个选项：

1. Sign Up（注册）
2. Sign In（登录已有账号）
3. Continue without an account（不登录直接用，功能受限）

我们选 Sign Up。

它会跳到浏览器，让你完成注册。注册方式有三种：

• Email + 密码：填邮箱 + 设密码。
• Google 账号：一键登录（如果你有 Google 账号）。
• GitHub 账号：一键登录（如果你有 GitHub 账号）。

国内用户建议：用邮箱注册最稳。Google 和 GitHub 登录在国内不一定能直接打开。

注册完会自动跳回 Cursor 应用，你会看到自己的头像出现在右上角，登录成功。

3.2 选择计划

注册时会问你"选哪个计划"。

直接选 Hobby（Free）。我们整本书前 11 章基本都能在免费档跑通，等你确认 Cursor 真的好用了再升 Pro 也不迟。

Cursor 偶尔会送你 14 天免费 Pro 试用。如果给了，建议接受——14 天足够你完整体验所有功能。

3.3 选择"导入设置"

Cursor 会问你："想从 VS Code / Cursor 旧版本 / 其他编辑器导入设置吗？"

• 如果你没用过 VS Code：选「Start from scratch」（从头开始）。
• 如果你用过 VS Code：选「Import from VS Code」，你的所有插件、主题、快捷键都会原样搬过来。

第一次用的人选「Start from scratch」即可。

3.4 选择"键位风格"

它还会问你喜欢哪种快捷键风格：

• VS Code（默认推荐）
• Vim（如果你是老程序员）
• Emacs（如果你是老老程序员）

普通人选 VS Code。本书后面所有快捷键都按 VS Code 风格。

3.5 选择"AI 风格"

最后会问你："你希望 AI 行为偏向？"

• Conservative（保守）：每次改动都让你确认。
• Standard（标准）：常规改动直接做，重要的让你确认。
• YOLO（你自己看着办）：AI 直接动手，不问你。

第一次选 Standard。等你完全熟练后再考虑 YOLO。

四、把界面切成中文

Cursor 默认英文。我们把它切成中文，对中文用户更友好。

步骤 1：在 Cursor 里按 Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Win/Linux）。

这是 Cursor 的"命令调色板"——所有功能都能在这里搜索调用，是 Cursor 第一个必须记住的快捷键。

步骤 2：在弹出的搜索框里输入 Configure Display Language，回车。

步骤 3：在弹出的列表里选择「Install additional languages…」，会跳到插件市场。

步骤 4：搜索 Chinese (Simplified)，找到「中文（简体）语言包」，点「Install」。

步骤 5：装完后，左下角会弹出"是否重启以应用语言"，点「Restart」。

步骤 6：重启后，整个 Cursor 界面就变成中文了。

不喜欢中文界面？再次按 Cmd+Shift+P，输入 Configure Display Language，选 en 就能切回英文。

五、看懂 Cursor 的界面

重启后你会看到 Cursor 的主界面。我们把它分成 7 块讲清楚：

┌─────────────────────────────────────────────────────────────┐
│  ① 顶部栏（菜单 / 文件名 / 模型选择）                      │
├──────────┬──────────────────────────────┬───────────────────┤
│          │                              │                   │
│   ②      │           ④                  │     ⑤             │
│ 左侧栏   │     主编辑区                 │   右侧 AI 面板    │
│ (文件夹) │     (你的文件)               │   (Chat / Agent)  │
│          │                              │                   │
├──────────┴──────────────────────────────┴───────────────────┤
│  ⑥ 终端面板（默认收起，按 Ctrl+`打开）                      │
├──────────────────────────────────────────────────────────────┤
│  ⑦ 状态栏（语言 / 行号 / 编码 / 模型用量）                  │
└──────────────────────────────────────────────────────────────┘

记住几个最关键的快捷键：

三个红色的字母 L / I / K 就是 Cursor 最核心的三块功能，你只要记住"L 是聊天 / I 是大动作 / K 是小修改"，剩下都好办。

六、第一个项目：你的个人简介页

下面我们做一个真东西——一个你可以发到朋友圈或简历里的"个人简介网页"。

整个过程你不需要写任何一行代码。

6.1 新建项目文件夹

步骤 1：在你的桌面新建一个文件夹，命名为 my-profile（不要用中文，避免后面部署遇到问题）。

步骤 2：在 Cursor 里点顶部菜单「文件」→「打开文件夹」，选中刚建的 my-profile 文件夹，点「打开」。

第一次 Cursor 会问"你信任这个文件夹的作者吗"。当然信任，因为是你自己建的。点「是的，我信任」。

打开后，左侧栏会显示 MY-PROFILE 文件夹（空的）。

6.2 让 AI 帮你做

步骤 1：按 Cmd+I（Mac）或 Ctrl+I（Win）打开 Composer。

Composer 出现在右侧，长得像一个聊天框。 Cursor 3 之后，这里也叫"Agents Window"。本书前期都直接叫"Composer"，到了 第九章 再讲它的高级用法。

步骤 2：确认右侧聊天框上方的"模式"是 Agent（不是 Ask 也不是 Manual）。

如果不是，点一下下拉菜单换到 Agent。

步骤 3：复制下面这段提示词到聊天框里：

我想做一个个人简介网页，要求：

1. 一个 index.html 文件就够了，所有 CSS 和 JavaScript 都内联，方便我直接打开看。
2. 整体风格：极简、白底、黑字、不要花哨的渐变。
3. 内容包括：
   - 顶部：我的名字（先用"张三"占位）+ 一句话职业简介（"产品经理 / 设计师 / 业余摄影爱好者"）。
   - 中间：3 段"关于我"的介绍（先用 Lorem ipsum 占位，每段 50 字）。
   - 一个"我的项目"区域，3 个项目卡片（标题 + 一句话描述 + 一个外链按钮）。
   - 一个"联系我"区域，包含微信、邮箱、GitHub、X（Twitter）的图标和链接占位。
4. 响应式：手机打开也好看。
5. 字体用系统默认，不要引入网络字体。
6. 顶部要平滑滚动效果，点导航能滑到对应区域。

请直接生成 index.html 到当前文件夹。生成完后告诉我怎么打开预览。

步骤 4：按回车 或 点击发送按钮。

接下来你会看到 Cursor：

1. 思考几秒（屏幕上显示"Thinking…"）。
2. 决定要创建一个 index.html 文件。
3. 在主编辑区生成代码（你能看到代码一行一行往下蹦）。
4. 在文件管理区出现 index.html。
5. 在右侧 Composer 里告诉你"已完成，请打开 index.html 在浏览器里查看"。

整个过程大约 30-90 秒。

6.3 打开预览

有 3 种方式打开你刚做好的页面：

方式 1（最简单）：打开你电脑上的 桌面 / my-profile 文件夹，找到 index.html，双击它，浏览器就会打开。

方式 2（最专业）：在 Cursor 里点 index.html 文件，按 Ctrl+` 打开终端，输入：

open index.html        # macOS
start index.html       # Windows
xdg-open index.html    # Linux

回车，浏览器自动打开。

方式 3（推荐 - Cursor 内置浏览器）：在 Cursor 里按 Cmd+Shift+P，输入 Simple Browser，选「Show」，然后输入 file:///你的文件路径/index.html，预览直接显示在 Cursor 里。

无论哪种方式，你应该能看到一个简洁、能用的个人页面。

6.4 改一改

第一次生成的页面肯定不是 100% 你想要的。我们继续让 AI 改。

回到右侧 Composer，输入：

1. 把名字"张三"改成"李白"。
2. 把"产品经理 / 设计师"改成"设计师 / 旅行作家 / 摄影爱好者"。
3. 把项目卡片背景改成淡灰色 #f7f7f7，加 1px 的更深灰色 #e0e0e0 边框。
4. 把"关于我"的三段 lorem 改成下面三段（直接用，不要再生成 lorem）：

我是一个习惯把生活拆成"想做的"和"必须做的"两个清单的人，过去十年大部分时候我都把"必须做的"放在前面，结果错过了很多想做的。

2024 年开始我做了个相反的实验：每天早上先花一小时做"想做的"，发现"必须做的"反而更轻松。这成了我现在最珍惜的习惯。

最近正在写一本关于"30 岁后重新学一门手艺"的小书，欢迎你和我聊聊你重新开始学的东西。

5. 把"联系我"区域的微信和邮箱改成可点击复制（点击后浮一个小气泡说"已复制"）。

按回车。

Cursor 会"diff"出修改前后的对比给你看（红色是删的、绿色是加的）。你可以：

• 点 ✓「Accept All」全部接受。
• 点 ✗「Reject All」全部拒绝。
• 一处一处地点 ✓ / ✗ 选择性接受。

接受后，重新刷新浏览器（按 F5），新版页面立即生效。

6.5 再加一点高级感

继续在 Composer 里输入：

1. 在最顶部加一个固定导航栏，包含三个锚点：「关于」「项目」「联系」。
2. 鼠标悬停在项目卡片上，让卡片有一个轻微的"上浮 + 阴影"动效。
3. 在最底部加一行小字版权信息："© 2026 李白. Made with Cursor."（居中、灰色、12px）。
4. 给整个页面加一个深色模式（点右上角小月亮图标切换），切换状态用 localStorage 记住。

回车，等几十秒，再刷新浏览器。

至此，你已经做出了一个比 80% 网上"个人主页模板"都好看的页面。

6.6 你刚才到底做了什么

你做的事情用"传统语言"来说是：

• 写了一个完整的 HTML 文件（结构）。
• 写了几百行 CSS（样式 + 响应式）。
• 写了上百行 JavaScript（导航、复制、深色模式、动效）。
• 做了一个完整的前端项目。

但你实际上只做了：

• 在右侧聊天框里复制粘贴了 2 段中文。
• 看了几次预览。
• 点了几次「Accept」。

这就是 Cursor 的魔力。

七、5 个新手最容易遇到的报错

7.1 报错 1：右侧 Composer 一直转圈不出结果

症状：你按 Cmd+I，输入提示词，回车后画面卡在"Thinking…"超过 5 分钟。

原因：网络问题，Cursor 连接不到 AI 模型服务器。

解决：

1. 检查你的网络。如果用了梯子，确认梯子能正常访问 cursor.com。
2. 在 Cursor 里点右上角的模型下拉菜单，换一个模型试试（比如从 composer-2 换到 claude-4.6-sonnet）。
3. 关掉 Cursor，重新打开。
4. 极端情况：去 Cursor 状态页 看是不是服务挂了。

7.2 报错 2：用量超限

症状：用着用着突然弹出 "You've used your free quota for this month"（你已经用完本月免费额度）。

原因：免费档每个月有限定的 AI 调用次数。

解决：

1. 等下个月（重置在每月 1 号）。
2. 升级到 Pro（$20）。
3. 切换到"自带 API Key"模式：在「设置」→「Models」里填上你自己的 OpenAI / Anthropic / DeepSeek 的 API Key，按调用付费。这种方式没有月度上限，按用量付。

7.3 报错 3：AI 改了我的文件，我不喜欢，怎么撤回

症状：你点了「Accept」，然后才发现改得不对。

解决（按推荐顺序）：

1. 直接 Ctrl+Z：编辑器内的标准撤销快捷键，可以一步步撤销。
2. Cursor 自带的 "Restore Checkpoint"：在 Composer 历史里，每次 AI 改动旁有一个小图标"Restore"，点它能回到那一刻的状态。
3. Git 撤销（推荐！）：如果你提前用 Git 提交了一次，随时可以 git reset --hard HEAD 回到上次提交状态。后面 第十二章 会专门讲。

重要建议：每次准备让 AI 大改之前，先在终端跑一句 git add -A && git commit -m "before AI"。这样你就有了"后悔药"。

7.4 报错 4：中文界面显示乱码

症状：装完中文语言包后，部分按钮变成乱码方块。

原因：你的系统缺少某种字体。

解决：

1. macOS：自动有思源字体，理论上不会出问题。
2. Windows：去微软商店搜「Microsoft YaHei UI」装上。
3. Linux：sudo apt install fonts-noto-cjk（Ubuntu / Debian）。

7.5 报错 5：Cursor 启动后白屏 / 卡死

症状：点击 Cursor 图标，界面打开后是一片白色，或者完全没响应。

原因：可能是缓存损坏、扩展冲突、显卡驱动问题。

解决（按顺序试）：

1. 完全退出 Cursor，重新打开。

2. 在终端跑：

   # macOS
   rm -rf ~/Library/Application\ Support/Cursor/Cache
   rm -rf ~/Library/Application\ Support/Cursor/CachedData
   
   # Windows（PowerShell）
   Remove-Item -Recurse -Force "$env:APPDATA\Cursor\Cache"
   Remove-Item -Recurse -Force "$env:APPDATA\Cursor\CachedData"
   
   # Linux
   rm -rf ~/.config/Cursor/Cache ~/.config/Cursor/CachedData
   

3. 如果还不行，卸载重装（你的设置和登录会保留）。

4. 加上启动参数禁用硬件加速：cursor --disable-gpu。

八、把项目"留下来"

这个项目我们做了一个晚上，但是 Cursor 关掉之后下次怎么找？

8.1 文件本身在哪儿

直接在「桌面 / my-profile」文件夹里。Cursor 不会"偷偷"把你的文件移走。

8.2 怎么再次打开

两种方式：

1. 在 Cursor 里：按 Cmd+O（Mac）或 Ctrl+O（Win），选 my-profile 文件夹。或者顶部「文件 → 打开最近」，会显示你最近打开过的项目。
2. 从文件管理器：右键 my-profile 文件夹，选「Open with Cursor」（Mac 是「打开方式 → Cursor」）。

8.3 历史对话保留吗？

保留。 你下次打开这个项目，按 Cmd+I，能看到上次和 AI 的对话历史，可以接着改。

九、给"想多走一步"的你

如果你做完上面这些觉得"还想再做一个"，这里给你 3 个练手任务：

任务 A：扩展你的简介页

• 增加一个"博客"区域，放 3 篇文章卡片（标题 + 摘要 + 阅读全文）。
• 增加一个"现在做什么"区域（仿照 now.justinmind.com 的风格）。
• 把页面发到 Vercel 上线（第十一章 会专门教）。

任务 B：做一个待办清单

• 新建文件夹 todo-app。
• 让 Cursor 做一个简单的待办清单 web app，能添加、勾选、删除待办，本地存储。
• 加深色模式 + 拖拽排序。

任务 C：做一个"今日心情"打卡器

• 新建文件夹 mood-tracker。
• 让 Cursor 做一个网页：每天点击一个表情记录今天心情，自动按月份生成一张"心情日历"。

每完成一个，你都能感受到 Cursor 的"边界"和"潜力"。

本章一图回顾

五分钟快速上手 —— 你刚才做了什么
═════════════════════════════

1. 安装 Cursor
   └── 三平台一键下载 + 自动识别芯片版本

2. 首次启动
   ├── 注册（邮箱 / Google / GitHub）
   ├── 选 Hobby 免费档
   ├── 「Start from scratch」
   ├── VS Code 键位
   └── Standard 风格

3. 切中文
   └── Cmd+Shift+P → Configure Display Language

4. 三个核心快捷键
   ├── Cmd+L  → 聊天（轻问）
   ├── Cmd+I  → Composer（动手做事）
   └── Cmd+K  → 选中代码后行内修改

5. 第一个项目
   ├── 新建文件夹 my-profile
   ├── 用 Cmd+I 让 Cursor 生成 index.html
   ├── 在浏览器里预览
   └── 用 Cmd+I 让 Cursor 改样式 / 加功能

6. 5 大首次报错
   ├── 一直转圈 → 网络 / 换模型
   ├── 用量超限 → 等月初 / 升 Pro / 自带 API Key
   ├── 改坏了 → Ctrl+Z / Restore Checkpoint / Git
   ├── 中文乱码 → 装思源字体
   └── 启动白屏 → 清缓存 / 重装

下章预告

接下来 第三章 三种对话方式，我们正式认识 Cursor 的"沟通三件套"——Tab、Cmd+K、Chat。学会这三个，你就掌握了 Cursor 90% 的日常用法。

如果你已经迫不及待想做更复杂的项目，也可以直接跳到 第四章 Composer 与 Agent。