从 JetBrains 过来的人怎么用 Cursor：迁移路径与集成定位

2026-08-18

先把一件事说清楚：这篇文章的依据只有 Cursor 一方的官方文档。JetBrains 系 IDE 的能力、插件生态、性能表现都不在我们的资料范围内，所以下面不会出现任何「JetBrains 怎么样、Cursor 怎么样、谁更好」的比较。能比的只有一件事——Cursor 官方文档为「你原来在用 JetBrains」这个处境准备了哪几条路，每条路的边界划在哪里。

Cursor 官方文档给出的是两条路，而且是明确分开写的：

一条在 cursor.com/help/getting-started/migrate-jetbrains，讲的是换编辑器——把日常工作搬到 Cursor 桌面端；
另一条在 cursor.com/docs/integrations/jetbrains，讲的是不换编辑器——留在原来的 IDE 里，通过 ACP（Agent Client Protocol）连上 Cursor 的 agent。

这两条路不是同一件事的两种说法，前置条件和能力边界都不一样。下面分别过一遍，最后给决策路径。

第一条路：换到 Cursor 桌面端，文档提了三件事

migrate-jetbrains 这一页很短，一共三个问答，最后一问讲的是「不换编辑器行不行」，也就是下面第二条路。真正落在「换编辑器」上的是前两问，里面藏着三个迁移时的真实摩擦点。

快捷键：装一个 keymap 扩展

官方文档写明的做法是装「IntelliJ IDEA Keybindings」这个扩展来保留肌肉记忆，步骤是四步：打开 Extensions 面板、搜索该扩展名、安装、重载 Cursor。

打开 Extensions 面板的快捷键，文档按平台分开写了：

Mac：Cmd + Shift + X
Windows / Linux：Ctrl + Shift + X

本站读者以 Windows 居多，这里用的是后一组。这些都是官方文档写明的键位，不是我们自己看到的界面——我们没有装过、跑过这个产品，全文不会出现任何界面外观或操作手感的描述。

项目模型：从「打开项目」变成「打开文件夹」

官方文档的原话是 Cursor 使用 file-and-folder 的项目模型，让你用 File > Open Folder 打开一个文件夹，而不是去创建一个项目。这句话在迁移当天最容易卡住人：你按老习惯去找「新建项目」，找不到就以为哪里配错了。

至于 JetBrains 那边的项目系统具体是怎么组织的，不在我们的资料里，不展开。

语言支持来自扩展，而不是内置

官方文档写明：语言支持来自扩展（extensions），而不是内置插件；大多数语言需要你从 marketplace 装对应扩展，文档举的例子是 Python 装 “Python”、Go 装 “Go”。

这条看着平淡，但它连着 Cursor 扩展体系里几个必须知道的事实，都写在 cursor.com/help/customization/extensions：

Cursor 用的是 Open VSX 扩展注册表，不是 VS Code Marketplace。文档写明「大多数流行扩展在 Open VSX 上可以找到，但不是每一个 Microsoft Marketplace 扩展都在上面」；
同一个 publisher.extension 名字，在 Open VSX 上可能指向与 Microsoft Marketplace 上不同的发布者或代码。文档给的建议是把扩展 ID 当依赖对待，只从你信任的发布者安装；
对于部分在 Open VSX 上没有的常用扩展，Cursor 发布了第一方的 Anysphere 替代版本——注意文档的措辞是 “some”，不是全部；
扩展的搜索和下载走 Cursor 自己的 marketplace 代理（marketplace.cursorapi.com），在展示和下发之前会跑自动化的恶意软件与供应链分析，未通过审查的会被拦截。文档同时写了一句很克制的话：没有任何单一控制手段能取代其它手段。

所以「换编辑器」这条路上，最可能咬到你的不是编辑习惯，而是你团队日常依赖的某个扩展在 Open VSX 上到底有没有、是不是同一份代码。这件事只能你自己按扩展清单逐个核。

顺带说一处文档口径的差异：Cursor 为 VS Code 用户准备了一键导入（cursor.com/help/getting-started/migrate-vscode 里写明在 Cursor Settings 的 General > Account 下有 VS Code Import，可以把扩展、主题、设置和键位一起带过来）。JetBrains 侧我们在 Cursor 官方文档里没有找到对应的一键导入说明——文档给的只是上面那个 keymap 扩展。别按 VS Code 那条路的预期去找导入按钮。

如果你是给团队做迁移，extensions 那一页还有几个团队侧的开关值得先看：Marketplace Install Cooldown（团队设置里按小时延后扩展安装与更新，文档写明默认值是 0，即关闭；设为大于 0 时全队生效，并覆盖用户自己的 extensions.installCooldownHours）、Allowed extensions（按发布者或扩展 ID 限制安装，可在团队面板或通过 MDM 的 AllowedExtensions 配置）、以及要求 Open VSX 扩展签名校验。文档特意注明，安装冷却和签名校验属于客户端侧的安装控制，是对 marketplace 层分析的补充而非替代。默认值随版本可能变动，以官方文档最新内容为准。

第二条路：留在原来的 IDE，用 ACP 接 agent

cursor.com/docs/integrations/jetbrains 这一页的定位很直接：在 JetBrains 系 IDE 里通过 ACP（Agent Client Protocol） 使用 Cursor 的 AI agent。

前置条件（这一段别跳过）

官方文档列出的前置条件有两条：

一个付费的 Cursor 套餐（具体档位与价格本文不涉及，以官方定价页为准）；
一个启用了 AI Assistant 插件的 JetBrains IDE，文档标注的版本要求是 2025.1+。

这两条决定了这条路能不能走通。尤其第二条：版本不够就没有下文，这是既成的版本要求，不会因为行情变动而改变。

官方给出的步骤

文档给的流程是四段：打开 AI Chat 面板（文档写明可以从 View > Tool Windows > AI Chat 进入）→ 在面板里打开 agent provider 列表，选 Add Agent from Registry，搜索 Cursor 并安装 → 安装后把 Cursor 选为 agent provider → 在面板里发 prompt。

以上菜单名与按钮名都是官方文档写明的，我们没有实际操作过，界面长什么样不在本文讨论范围内。

这条路能拿到什么，文档只写了三条

这是整篇最需要划重点的地方。官方文档的措辞是：Cursor ACP 在 JetBrains IDE 里提供了「many of the same agent capabilities」——是「许多相同能力」，不是「全部能力」。文档随后明确列出的只有三项：

文档列出的能力	文档写明的内容
Model selection	可以在多种模型之间切换，按任务挑选
File editing	agent 读写项目文件，改动反映到 IDE 编辑器里
Terminal commands	agent 在 IDE 集成终端里执行 shell 命令

（具体有哪些模型、各自什么价格与上下文长度，属于随时变动的内容，本文一概不写。）

第三行值得停一下：agent 会在你 IDE 的集成终端里跑 shell 命令。这是本机执行外部命令，权限边界必须自己心里有数——下面 ACP 的权限机制那一段是配套的。

机制与边界：文档在 ACP 页写了什么

cursor.com/docs/cli/acp 这一页讲的是 Cursor CLI 的 ACP 模式，也是上面那条集成路径的协议底座。与「要不要留在原 IDE」这个决策直接相关的有三点：

一、谁是 client 谁是 server。 文档写明你的 JetBrains IDE 作为 ACP client，Cursor 的 agent 作为 server；发出的 prompt 由 AI Chat 插件通过 ACP 转给 agent，agent 再把编辑与终端命令流式送回 IDE。这是文档自述的角色划分，我们不推断它内部怎么实现。

二、模式和权限是有档位的。 ACP 会话支持与 CLI 相同的三种核心模式：agent（完整工具访问）、plan（规划，只读行为）、ask（问答，只读行为）。工具需要批准时，Cursor 发出 session/request_permission，客户端应当返回 allow-once、allow-always、reject-once 三者之一。文档还写了一句很实在的话：如果你的 client 不回答权限请求，工具执行可能会阻塞。用现成集成时你未必碰得到这层，但排查「卡住不动」时它是第一个该想到的点。

三、MCP 有一条明确的不支持。 文档写明 ACP 支持项目级或用户级 .cursor/mcp.json 里定义的 MCP servers，需要从项目目录启动 agent 并批准要用的 server；但通过 Cursor dashboard 配置的团队级 MCP servers 在 ACP 模式下不受支持。这一条是本篇最硬的边界：如果你们团队的 MCP 是在 dashboard 上统一配的，走 ACP 这条路它不会跟过来。

想自己搭客户端的话，文档给的典型会话流程是七步：initialize → 用 methodId: "cursor_login" 做 authenticate → session/new（或 session/load）→ session/prompt → 处理流式的 session/update → 处理 session/request_permission → 视情况发 session/cancel。这属于另一个话题，本文不展开。

Windows 与 macOS/Linux 的安装差异

如果你要在本机装 Cursor CLI（ACP 模式由它提供，官方文档的命令是 agent acp），cursor.com/docs/cli/installation 把平台分得很清楚：

macOS、Linux 以及 Windows 的 WSL：

curl https://cursor.com/install -fsS | bash

Windows 原生：

irm 'https://cursor.com/install?win32=true' | iex

装完之后验证：

agent --version

文档在安装后步骤里要求把 ~/.local/bin 加进 PATH，并分别给了 bash 与 zsh 的写法；Windows 原生侧的 PATH 处理，官方文档没有单独说明这一点。CLI 默认会尝试自动更新，手动更新用 agent update。

以上为按官方文档中的参数语义组合的示例，未经实测，以官方文档与 --help 的实际输出为准。

决策路径：按你的处境倒推

把上面这些串成一条可执行的判断顺序：

你们团队的 MCP servers 是在 Cursor dashboard 上统一配的吗？ 是的话，「留在原 IDE 走 ACP」这条路会缺这一块——文档明写不支持。要么改成项目级 / 用户级 .cursor/mcp.json，要么这条路就得让位。
JetBrains IDE 的版本够不够、AI Assistant 插件开没开？ 文档要求 2025.1+ 且插件启用。不满足，第二条路直接不成立，不用再往下比。
有没有付费 Cursor 套餐？ 文档把它列为前置条件。没有的话第二条路同样不成立。
你日常依赖的扩展在 Open VSX 上有没有、是不是同一份代码？ 这一条卡的是第一条路。文档已经提醒了同名不同源的风险，也说明只有「部分」缺失扩展有 Anysphere 替代。逐个核完再决定。
你需要的能力是不是超出了文档列出的那三项？ ACP 集成侧官方明确写出来的只有模型选择、文件编辑、终端命令三项，措辞是「许多相同能力」。你想要的那项如果不在这三项里，Cursor 官方文档没有写明它在 JetBrains 侧是否可用——这一点我们没有依据，不比，别按「应该也有」去规划。

这两条路也不是互斥的。ACP 这条路本身的定位就是「你保留原有的 IntelliJ 或 WebStorm 配置，通过协议访问 Cursor 的 agent」——文档原话如此，渐进迁移的空间在文档里是存在的。

最后重复一句该重复的：以上全部来自官方文档的文字，不是我们的使用结论。菜单名、设置项、版本要求都可能随版本变动，动手前请以官方文档最新内容为准。

本文依据 Cursor 官方文档（cursor.com/docs 与 cursor.com/help）于 2026-08-18 的公开内容整理。该产品闭源，本文只复述官方文档写明的机制，不推断其内部实现； 我们没有对文中涉及的功能做过实测，因此不涉及界面外观、操作手感与运行速度的任何描述。该产品迭代频繁，文中涉及的设置项与命令随版本变动，请以官方文档最新内容为准。本文不涉及订阅价格、额度与模型清单，相关信息请以官方定价与模型说明页为准。

本文对照的是同一产品内的两种形态，依据均为上述官方文档，不对两种形态做优劣排名，选型结论只在官方文档写明的能力边界内成立。

安全与合规相关做法请结合自身环境评估，本文不构成安全方案建议。