安装与迁移
从 Cursor 官方安装、VS Code 迁移和 JetBrains 迁移文档梳理安全迁移路径。
安装 Cursor 本身不复杂，真正容易出错的是迁移：把旧编辑器里的扩展、快捷键、设置和项目习惯不加筛选地搬进来。Cursor 官方 Help Center 分别提供安装、VS Code 迁移和 JetBrains 迁移说明，本章把它们整理成一条可控路径。
阅读目标：读完本章，你应该能完成 Cursor 安装，并判断 VS Code / JetBrains 迁移时哪些可以直接导入，哪些需要重新审查。
1. 官方安装流程
官方 Help Center 给出的安装步骤：
- 打开 cursor.com/download。
- 点击当前操作系统对应的下载按钮。
- 打开下载文件。
- 按系统完成安装。
- 打开 Cursor。
- 按提示登录 Cursor account。
- 用 File > Open Folder 打开项目目录。
不同系统的具体动作：
| 系统 | 安装动作 |
|---|---|
| macOS | 把 Cursor 拖到 Applications |
| Windows | 运行安装器并按提示操作 |
| Linux | 优先用 apt / dnf 包；也可使用 AppImage 或 archive |
2. 从 VS Code 迁移
官方 VS Code 迁移文档说明，Cursor 可以一键导入 VS Code settings、keybindings 和 extensions。
路径：
- 打开 Cursor Settings。
- macOS 按
Cmd + Shift + J，Windows / Linux 按Ctrl + Shift + J。 - 进入 General > Account。
- 在 VS Code Import 下点击 Import。
导入内容包括：
- extensions。
- themes。
- settings。
- keybindings。
Cursor 使用 Open VSX extension registry（开放扩展注册表，是 VS Code Marketplace 的开源替代品），不是 VS Code Marketplace。很多常见扩展可用，但不是所有 VS Code 扩展都一定存在或完全一致——部分商业 / 闭源扩展可能找不到对应版本。
3. 从 JetBrains 迁移
官方 JetBrains 迁移文档强调两点：快捷键和项目模型。
保留快捷键肌肉记忆：
- 打开 Extensions panel。
- macOS 按
Cmd + Shift + X，Windows / Linux 按Ctrl + Shift + X。 - 搜索
IntelliJ IDEA Keybindings。 - 安装扩展。
- 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. 迁移时不要照搬一切
从旧编辑器迁移时，建议分三层：
flowchart TD
Old["旧编辑器配置"] --> Must["必须迁移"]
Old --> Review["需要审查"]
Old --> Drop["不迁移"]
Must --> Keymap["快捷键 / 主题 / 基础格式化"]
Review --> Extensions["扩展 / AI 插件 / 终端配置"]
Drop --> Secrets["密钥 / 本地临时路径 / 旧实验配置"]
Extensions --> Verify["打开低风险项目验证"]可以迁移：
- 常用快捷键。
- 主题。
- 基础格式化设置。
- 语言服务扩展。
需要重新审查：
- 会联网的扩展。
- 旧 AI 插件。
- 终端启动脚本。
- 自动格式化或保存时执行命令。
不要迁移：
- 本机私有路径。
- 明文密钥。
- 客户或生产环境凭据。
- 旧项目临时 workaround。
深读：为什么迁移后先用低风险项目验收
迁移会把旧编辑器习惯带进 Cursor，但 Cursor 还会额外引入 Agent、Plan Mode、Rules、MCP、Terminal、Browser 和 Cloud Agent 等能力。一个旧扩展或旧终端脚本在普通 IDE 里只是便利，在 AI agent 环境里可能变成更大的副作用入口。
所以迁移完成后，先打开低风险项目，跑一次只读解释、小改动、diff review 和检查命令。确认没有异常，再进入真实项目。
5. 安装迁移验收清单
至少确认：
- Cursor 来自官方下载入口。
- 已登录正确账号。
- VS Code 导入后扩展可用。
- JetBrains keymap 如需保留已安装。
- 能用 File > Open Folder 打开测试项目。
- Agent 能只读解释代码库。
- 做一个小改动后能 review diff。
- 没有把明文密钥或生产凭据带进 Cursor 配置。
本章自检
完成本章后，用这 3 个问题检查自己是否真正理解：
- Cursor 从 VS Code 导入哪些内容？扩展来源有什么差异？
- 从 JetBrains 迁移时，项目模型最大的变化是什么？
- 为什么安装迁移后不应该马上打开生产仓库？
通过标准：你能完成安装和迁移，并用低风险项目验证 Cursor 的基础读写、diff review 和扩展状态。
官方来源
- Cursor Install Help —— 官方安装流程和 File > Open Folder 起步方式。
- Cursor Migrate from VS Code —— 官方 VS Code 设置、快捷键、主题和扩展导入说明。
- Cursor Migrate from JetBrains —— 官方 JetBrains keymap、file-and-folder project model、语言扩展和 ACP 说明。