安装、迁移和第一个项目

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

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

1. 安装阶段只做三件事

官方安装路径很直接：

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

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

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

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

官方路径：

打开 Cursor Settings。
macOS 按 Cmd + Shift + J，Windows / Linux 按 Ctrl + Shift + J。
进入 General > Account。
在 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 扩展来保留快捷键手感。安装路径：

打开 Extensions panel：macOS 按 Cmd + Shift + X，Windows / Linux 按 Ctrl + Shift + X。
搜索 IntelliJ IDEA Keybindings。
安装该扩展。
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 分钟闭环

按这个顺序执行：

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 建议这样写：

只读分析这个项目。不要修改文件，不要运行破坏性命令。
请输出：
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

看三件事：

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

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：官方安装步骤和 Open Folder 起步方式。
Migrate from VS Code：settings、keybindings、themes、extensions 导入说明。
Migrate from JetBrains：keybindings、project model、language extensions 和 ACP 说明。
Cursor Documentation Index：官方 Help Center 和 docs 页索引。

接下来去哪

先确认 Cursor 的产品定位和学习路线。

理解 Agent 的 instructions、tools、model、checkpoints 和 queue。

官方安装迁移

回到官方重组页查看安装与迁移细节。