---
title: "安装、迁移和第一个项目"
description: "从下载安装到迁移 VS Code / JetBrains，再用低风险项目跑通 Cursor 第一天闭环。"
verifiedAt: "2026-05-09"
---

第一次打开 Cursor，不要急着让 Agent 重构项目。正确目标是完成一个低风险、可回退、可验证的 first project loop（首个项目闭环）：安装可信、迁移可控、上下文可读、改动可审查、验证能跑通。

> [!NOTE]
> **本章目标**：你会完成安装和迁移，并用一个小项目验证 Cursor 的 read context、small edit、diff review 和 command check，而不是把真实生产仓库当试验场。

## 1. 安装阶段只做三件事

官方安装路径很直接：

1. 从 [cursor.com/download](https://cursor.com/download) 下载。
2. 按系统安装：macOS 拖入 Applications，Windows 运行 installer，Linux 优先用 apt / dnf 包，也可用 AppImage 或 archive。
3. 打开 Cursor，登录 Cursor account，用 **File > Open Folder** 打开项目目录。

这一步不要混进太多配置。先确认你拿到的是官方安装包，账号是正确账号，应用能打开一个普通 folder。

## 2. VS Code 迁移：能导入，但要筛选

Cursor 官方 Help Center 说明，可以从 VS Code 导入 settings、keybindings、themes 和 extensions。

官方路径：

1. 打开 Cursor Settings。
2. macOS 按 `Cmd + Shift + J`，Windows / Linux 按 `Ctrl + Shift + J`。
3. 进入 **General > Account**。
4. 在 **VS Code Import** 下点击 **Import**。

但"能导入"不等于"全部都该导入"。Cursor 使用 Open VSX extension registry（开放扩展注册表，是 VS Code Marketplace 的开源替代品），不是 VS Code Marketplace，所以扩展兼容性和来源不完全相同——部分商业扩展可能在 Open VSX 找不到对应版本。

建议分三类处理：

- **直接导入**：主题、基础 keybindings、Prettier / ESLint 这类成熟格式化工具。它们行为可预测、与 AI 无关，迁过来不会冲突。
- **导入后审查**：语言服务、Docker、database client、remote tools、Git helpers。这一类可能与 Cursor 自己的 AI 上下文有重叠或冲突，需要进项目跑一次再决定保留哪些。
- **不要直接迁移**：旧 AI 插件、自动运行命令的扩展、带本机路径或账号 token 的配置。旧 AI 插件会和 Cursor 自己的 Agent 抢上下文；自动跑命令的扩展会让权限边界变模糊。

## 3. JetBrains 迁移：先保留手感，再接受项目模型差异

从 JetBrains 切过来时，官方建议可以安装 `IntelliJ IDEA Keybindings` 扩展来保留快捷键手感。安装路径：

1. 打开 Extensions panel：macOS 按 `Cmd + Shift + X`，Windows / Linux 按 `Ctrl + Shift + X`。
2. 搜索 `IntelliJ IDEA Keybindings`。
3. 安装该扩展。
4. Reload Cursor 使快捷键生效。

更大的差异不是快捷键，而是 project model。

JetBrains 用户需要预期：

- Cursor 使用 file-and-folder project model（基于目录的项目模型）——和 JetBrains 的 IDEA Project 概念不同，Cursor 把"打开 folder"等同于"打开项目"，不需要先创建 `.idea/` 这种工程描述文件。
- 打开项目用 **File > Open Folder**。
- Python、Go、Java 等语言能力依赖相应 extensions。
- 如果暂时不想完全迁出 JetBrains，可以通过 ACP（Agent Client Protocol，代理客户端协议）让 Cursor agent 连接 JetBrains IDE。

也就是说，迁移不是把 IDE 复制一份，而是把工作流迁到 Cursor 的 folder、extensions、Agent 和 terminal 模型里。

## 4. 第一个项目选什么

第一个项目必须低风险。不要选客户项目、生产后台、支付链路、数据库 migration 或密钥很多的仓库。

合适的 first project：

- 有 Git。
- 能本地运行。
- 有 lint、test 或 build 命令。
- 规模不大，文件结构清楚。
- 就算改错也能直接丢弃 diff。

如果没有合适项目，就新建一个临时 demo repo。第一次练的是 Cursor 工作流，不是验证它能不能一次性解决复杂系统问题。

## 5. 第一天 45 分钟闭环

按这个顺序执行：

```mermaid
flowchart TD
  A["Open Folder"] --> B["Check Git Status"]
  B --> C["Read-only Project Summary"]
  C --> D["One Small Change"]
  D --> E["Run Verification"]
  E --> F["Review Diff"]
  F --> G["Decide Keep or Revert"]
```

### Step 1：打开项目后先看 Git

确认 working tree 干净，或者至少知道哪些改动不是 Cursor 做的。不要在一堆未识别改动上直接启动 Agent。

### Step 2：只读解释项目

第一条 prompt 建议这样写：

```text
只读分析这个项目。不要修改文件，不要运行破坏性命令。
请输出：
1. 主要技术栈
2. 入口文件
3. 常用开发命令
4. 测试 / lint / build 命令
5. 你认为最安全的第一个小任务
```

这个步骤验证 Cursor 能不能理解 project context，也验证你能不能看懂它给出的判断。

### Step 3：只做一个小改动

小改动可以是：

- 修一个文案 typo。
- 给一个纯函数补 test。
- 给一个组件补 empty state。
- 给 docs 增加一段说明。
- 给已有 test case 补一个边界。

不要第一次就做 dependency upgrade、authentication change、routing rewrite 或 database schema change。

### Step 4：跑验证

让 Cursor 运行最小验证命令，例如 `pnpm lint`、`pnpm test -- <file>`、`pnpm build`。如果命令会很慢，先让它解释命令含义和风险，再决定是否运行。

### Step 5：审查 diff

看三件事：

- 是否只改了你批准的范围。
- 是否引入无关格式化或大面积重排。
- 验证结果是否和它的总结一致。

> [!IMPORTANT]
> Cursor 的 final summary 不能替代 diff review。上线质量来自真实改动、真实检查和人工判断。

## 6. 常见错误

第一次使用 Cursor 最容易犯这些错误：

- 登录错账号，后面才发现用量和团队设置不对。
- VS Code 扩展全部导入，旧 AI 插件和自动化扩展互相干扰。
- 在未提交的真实项目里直接让 Agent 大改。
- prompt 里没有“不要修改文件”或“先给计划”。
- 没有跑任何验证，只看 Agent 文字总结。
- 改完后不沉淀 Rules，下一次重复踩坑。

## 7. 完成标准

第一次项目闭环完成时，你应该拿到：

- Cursor 已从官方入口安装。
- VS Code / JetBrains 迁移项已筛选。
- 已打开一个低风险项目。
- Cursor 已只读解释 project structure。
- 已完成一个 small edit。
- 已跑至少一个 verification command。
- 已看过 diff，并能决定 keep 或 revert。

具体到肉眼可见的样子：你可能改了 1 个 typo、`pnpm lint` 通过、`git diff` 只有 1-3 行红绿——这就算合格。如果第一次闭环跑完发现 diff 有 50+ 行散落改动，说明任务没拆够小，下次先把范围再压缩一半。

通过这个标准以后，再进入 Agent、Rules、MCP、Skills、CLI 和 Cloud Agent。

## 官方来源

- [Cursor Install Help](https://cursor.com/help/getting-started/install.md)：官方安装步骤和 Open Folder 起步方式。
- [Migrate from VS Code](https://cursor.com/help/getting-started/migrate-vscode.md)：settings、keybindings、themes、extensions 导入说明。
- [Migrate from JetBrains](https://cursor.com/help/getting-started/migrate-jetbrains.md)：keybindings、project model、language extensions 和 ACP 说明。
- [Cursor Documentation Index](https://cursor.com/llms.txt)：官方 Help Center 和 docs 页索引。

## 接下来去哪

<Cards>
  <Card title="上一篇" description="先确认 Cursor 的产品定位和学习路线。" href="/docs/cursor/understanding/01-what-is-cursor" />
  <Card title="下一篇" description="理解 Agent 的 instructions、tools、model、checkpoints 和 queue。" href="/docs/cursor/understanding/03-how-cursor-agent-works" />
  <Card title="官方安装迁移" description="回到官方重组页查看安装与迁移细节。" href="/docs/cursor/official/00-getting-started/02-install-and-migrate" />
</Cards>
