5 分钟上手 Cursor：从安装到第一个项目

上一篇我们对比了 Cursor、Claude Code 与 Codex 三款 AI 编程工具。今天，我们来实战：5 分钟快速上手 Cursor，从零到一完成你的第一个项目。

---

为什么选 Cursor？

在开始之前，先说说为什么 Cursor 值得你花 5 分钟：

• 最接近 VS Code：基于 VS Code 深度定制，学习成本最低
• 最强的代码理解：能理解整个项目结构，不只是单个文件
• 最灵活的交互：Tab 补全、Ctrl+K 快速编辑、Chat 对话三种模式
• 最好的兼容性：支持所有 VS Code 插件，扩展性最强

简单来说：如果你用过 VS Code，Cursor 就是"装了 AI 引擎的 VS Code"。

---

第一步：下载安装（1 分钟）

官方下载

访问 cursor.com 或直接下载：

• Windows: cursor-setup.exe
• macOS: cursor.dmg（Intel 与 Apple Silicon）
• Linux: cursor.AppImage 或 .deb

安装流程

1. 下载安装包
2. 双击运行，按提示完成安装
3. 启动 Cursor

就这么简单！ 整个过程不超过 1 分钟。

---

第二步：登录与配置（1 分钟）

创建账户

启动 Cursor 后，会提示登录：

1. 点击 Sign In
2. 用邮箱注册或用 GitHub 账号快速登录
3. 验证邮箱（如果是邮箱注册的话）

选择 AI 模型

登录后，Cursor 会让你选择默认模型：

• Claude 3.5 Sonnet（推荐）：最均衡，代码质量最强
• GPT-4o：速度快，适合快速迭代
• Gemini 2.0：新秀，性能不错

建议新手选 Claude 3.5 Sonnet，它在代码生成和理解上表现最稳定。

---

第三步：创建第一个项目（1 分钟）

新建项目

1. File → Open Folder，选择一个空文件夹（或新建一个）
2. 或者直接 File → New Folder

初始化项目

假设我们要写一个简单的 Python 爬虫。创建文件结构：

my-first-project/
├── main.py
├── requirements.txt
└── README.md

Cursor 会自动识别项目类型，并在右下角显示当前环境。

---

第四步：用 AI 写代码（2 分钟）

方式 1：Tab 补全（最快）

在 main.py 中输入：

import requests
from bs4 import BeautifulSoup

# 爬取 HackerNews 首页

按 Tab 键，Cursor 会自动补全整个函数。这就是 AI 的力量。

方式 2：Ctrl+K 快速编辑（最精准）

1. 选中代码
2. 按 Ctrl+K（Windows/Linux）或 Cmd+K（Mac）
3. 输入需求，比如"添加错误处理和日志"
4. Cursor 会在原地修改代码

方式 3：Chat 对话（最灵活）

按 Ctrl+L（Windows/Linux）或 Cmd+L（Mac），打开 Chat 面板，输入：

我想写一个爬虫，爬取 HackerNews 首页的标题和链接，
保存到 CSV 文件。用 requests 和 BeautifulSoup。

Cursor 会：

1. 理解你的需求
2. 查看你的项目结构
3. 生成完整代码
4. 自动创建 requirements.txt

一条消息，全部搞定！

---

实战示例：完整爬虫代码

这是 Cursor 生成的完整代码（我只改了一点点）：

import requests
from bs4 import BeautifulSoup
import csv
from datetime import datetime

def scrape_hackernews():
    """爬取 HackerNews 首页"""
    url = "https://news.ycombinator.com/"
    headers = {
        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
    }
    
    try:
        response = requests.get(url, headers=headers, timeout=10)
        response.raise_for_status()
    except requests.RequestException as e:
        print(f"请求失败: {e}")
        return
    
    soup = BeautifulSoup(response.content, "html.parser")
    stories = soup.select(".athing")
    
    data = []
    for story in stories[:30]:  # 取前 30 条
        title_elem = story.select_one(".titleline > a")
        if title_elem:
            title = title_elem.text
            link = title_elem.get("href", "")
            data.append({"title": title, "link": link})
    
    # 保存到 CSV
    filename = f"hackernews_{datetime.now().strftime('%Y%m%d_%H%M%S')}.csv"
    with open(filename, "w", newline="", encoding="utf-8") as f:
        writer = csv.DictWriter(f, fieldnames=["title", "link"])
        writer.writeheader()
        writer.writerows(data)
    
    print(f"成功爬取 {len(data)} 条新闻，保存到 {filename}")

if __name__ == "__main__":
    scrape_hackernews()

运行代码

pip install -r requirements.txt
python main.py

就这样，你的第一款 AI 辅助项目完成了！

---

关键快捷键速查

快捷键	功能	场景
Tab	AI 补全	快速补全代码
Ctrl+K	快速编辑	修改选中代码
Ctrl+L	Chat 对话	复杂需求、多文件协作
Ctrl+Shift+L	代码解释	理解陌生代码
Ctrl+I	内联编辑	在当前位置快速修改

---

常见问题

Q1: Cursor 是免费的吗？

部分免费。 Cursor 提供免费额度（每月 2000 次补全 + 50 次 Chat），超出后需要付费。

• Pro：$20/月，无限使用
• Business：$40/月，团队协作

对于学习和小项目，免费额度足够了。

Q2: 我的代码会被上传到云端吗？

不会。 Cursor 默认不上传代码。但如果你用 Claude 或 GPT-4 模型，会发送到对应 API（遵循隐私政策）。

如果担心隐私，可以在设置中选择本地模型或自托管方案。

Q3: Cursor 支持哪些编程语言？

所有主流语言：Python、JavaScript、Java、C++、Go、Rust、SQL 等。

Cursor 基于 VS Code，所有 VS Code 支持的语言，Cursor 都支持。

Q4: 如何让 Cursor 更好地理解我的项目？

1. 打开整个项目文件夹（不要只打开单个文件）
2. 创建 .cursorignore 文件，排除不需要的文件（类似 .gitignore）
3. 在 Chat 中提供上下文，比如项目的技术栈、架构说明

---

下一步：进阶技巧

现在你已经掌握了基础。下一篇我们会讲：

• @符号的魔力：如何用 @file、@folder 精准指定上下文
• Chat 模式深度用法：多轮对话、代码审查、重构
• 多文件编辑：一次修改整个项目的相关文件

---

总结

5 分钟快速上手 Cursor 的核心：

1. ✅ 下载安装（1 分钟）
2. ✅ 登录配置（1 分钟）
3. ✅ 创建项目（1 分钟）
4. ✅ 用 AI 写代码（2 分钟）

关键心态： Cursor 不是替代品，而是 加速器。它让你从"写代码"升级到"指挥 AI 写代码"。

下一次你写代码时，试试按 Tab 键。你会爱上这种感觉！

---