---
title: "安装与迁移"
description: "从 Cursor 官方安装、VS Code 迁移和 JetBrains 迁移文档梳理安全迁移路径。"
verifiedAt: "2026-05-09"
---

安装 Cursor 本身不复杂，真正容易出错的是迁移：把旧编辑器里的扩展、快捷键、设置和项目习惯不加筛选地搬进来。Cursor 官方 Help Center 分别提供安装、VS Code 迁移和 JetBrains 迁移说明，本章把它们整理成一条可控路径。

> [!NOTE]
> **阅读目标**：读完本章，你应该能完成 Cursor 安装，并判断 VS Code / JetBrains 迁移时哪些可以直接导入，哪些需要重新审查。

## 1. 官方安装流程

官方 Help Center 给出的安装步骤：

1. 打开 [cursor.com/download](https://cursor.com/download)。
2. 点击当前操作系统对应的下载按钮。
3. 打开下载文件。
4. 按系统完成安装。
5. 打开 Cursor。
6. 按提示登录 Cursor account。
7. 用 **File > Open Folder** 打开项目目录。

不同系统的具体动作：

| 系统 | 安装动作 |
| --- | --- |
| macOS | 把 Cursor 拖到 Applications |
| Windows | 运行安装器并按提示操作 |
| Linux | 优先用 apt / dnf 包；也可使用 AppImage 或 archive |

## 2. 从 VS Code 迁移

官方 VS Code 迁移文档说明，Cursor 可以一键导入 VS Code settings、keybindings 和 extensions。

路径：

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

导入内容包括：

- extensions。
- themes。
- settings。
- keybindings。

> [!IMPORTANT]
> Cursor 使用 Open VSX extension registry（开放扩展注册表，是 VS Code Marketplace 的开源替代品），不是 VS Code Marketplace。很多常见扩展可用，但不是所有 VS Code 扩展都一定存在或完全一致——部分商业 / 闭源扩展可能找不到对应版本。

## 3. 从 JetBrains 迁移

官方 JetBrains 迁移文档强调两点：快捷键和项目模型。

保留快捷键肌肉记忆：

1. 打开 Extensions panel。
2. macOS 按 `Cmd + Shift + X`，Windows / Linux 按 `Ctrl + Shift + X`。
3. 搜索 `IntelliJ IDEA Keybindings`。
4. 安装扩展。
5. Reload Cursor。

需要预期的差异：

| 差异 | 含义 |
| --- | --- |
| 项目模型 | Cursor 使用 file-and-folder project model（基于目录的项目模型），而不是 JetBrains project system；不需要 `.idea/` 工程描述文件 |
| 打开方式 | 用 **File > Open Folder**，不是创建 JetBrains 项目 |
| 语言支持 | 依赖扩展，例如 Python、Go 等语言扩展 |
| 不完全切换 | 可以通过 ACP（Agent Client Protocol，代理客户端协议）连接 Cursor agent 到 JetBrains IDE |

## 4. 迁移时不要照搬一切

从旧编辑器迁移时，建议分三层：

```mermaid
flowchart TD
  Old["旧编辑器配置"] --> Must["必须迁移"]
  Old --> Review["需要审查"]
  Old --> Drop["不迁移"]
  Must --> Keymap["快捷键 / 主题 / 基础格式化"]
  Review --> Extensions["扩展 / AI 插件 / 终端配置"]
  Drop --> Secrets["密钥 / 本地临时路径 / 旧实验配置"]
  Extensions --> Verify["打开低风险项目验证"]
```

可以迁移：

- 常用快捷键。
- 主题。
- 基础格式化设置。
- 语言服务扩展。

需要重新审查：

- 会联网的扩展。
- 旧 AI 插件。
- 终端启动脚本。
- 自动格式化或保存时执行命令。

不要迁移：

- 本机私有路径。
- 明文密钥。
- 客户或生产环境凭据。
- 旧项目临时 workaround。

<details>
<summary>深读：为什么迁移后先用低风险项目验收</summary>

迁移会把旧编辑器习惯带进 Cursor，但 Cursor 还会额外引入 Agent、Plan Mode、Rules、MCP、Terminal、Browser 和 Cloud Agent 等能力。一个旧扩展或旧终端脚本在普通 IDE 里只是便利，在 AI agent 环境里可能变成更大的副作用入口。

所以迁移完成后，先打开低风险项目，跑一次只读解释、小改动、diff review 和检查命令。确认没有异常，再进入真实项目。
</details>

## 5. 安装迁移验收清单

至少确认：

- Cursor 来自官方下载入口。
- 已登录正确账号。
- VS Code 导入后扩展可用。
- JetBrains keymap 如需保留已安装。
- 能用 **File > Open Folder** 打开测试项目。
- Agent 能只读解释代码库。
- 做一个小改动后能 review diff。
- 没有把明文密钥或生产凭据带进 Cursor 配置。

## 本章自检

完成本章后，用这 3 个问题检查自己是否真正理解：

1. Cursor 从 VS Code 导入哪些内容？扩展来源有什么差异？
2. 从 JetBrains 迁移时，项目模型最大的变化是什么？
3. 为什么安装迁移后不应该马上打开生产仓库？

通过标准：你能完成安装和迁移，并用低风险项目验证 Cursor 的基础读写、diff review 和扩展状态。

## 官方来源

- [Cursor Install Help](https://cursor.com/help/getting-started/install.md) —— 官方安装流程和 File > Open Folder 起步方式。
- [Cursor Migrate from VS Code](https://cursor.com/help/getting-started/migrate-vscode.md) —— 官方 VS Code 设置、快捷键、主题和扩展导入说明。
- [Cursor Migrate from JetBrains](https://cursor.com/help/getting-started/migrate-jetbrains.md) —— 官方 JetBrains keymap、file-and-folder project model、语言扩展和 ACP 说明。

## 接下来去哪

<Cards>
  <Card title="模型与定价" description="迁移完成后，再查模型、用量、Max Mode 和官方 pricing 边界。" href="/docs/cursor/official/00-getting-started/03-models-pricing" />
  <Card title="快速开始" description="回到第一天闭环：解释代码库、小改动、review diff 和检查命令。" href="/docs/cursor/official/00-getting-started/01-quickstart" />
</Cards>
