# 从 Windsurf 迁移

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

Windsurf 围绕高度可自定义且精简的设置构建，允许用户配置环境以适应特定工作流程。

IntelliJ IDEA 通过提供开箱即用的就绪环境，带来不同的体验。 内置的开发者工具包、深入的语言支持和高级 AI 功能从一开始即可使用，从而最大限度减少额外配置的需求。

如需查看 IntelliJ IDEA 的主要功能列表，请访问 [功能概览](https://www.jetbrains.com/zh-cn/idea/features/) 页面。

## 导入设置

为帮助您重建之前的设置，IntelliJ IDEA 允许您从您的 Windsurf 实例导入设置。 这包括按键映射、UI 主题设置、已安装的扩展程序和最近的项目。

> **Tip:**
> 如果您在首次启动时跳过导入，您可以 [手动导入您的设置](sharing-your-ide-settings.html#import-export-settings)，或者按照本指南后面的说明从头开始配置。

首次启动 IntelliJ IDEA 时，将看到   导入设置   对话框，其中列出了在机器上找到的其他 IDE 的设置。

Procedure:

1. 选择   风帆冲浪   以导入设置。

![带有从 Windsurf 导入设置选项的“导入设置”对话框。](https://resources.jetbrains.com/help/img/idea/2026.3/ij_import_cursor_settings.png)

2. 选择要导入的设置，然后点击   导入设置  。

![Windsurf 设置选择](https://resources.jetbrains.com/help/img/idea/2026.3/ij_import_windsurf_settings_selection.png)

* UI 主题 – 如果想导入主题设置，请选择此项。

* 按键映射 – 如果想导入键盘快捷键，请选择此项。 点击 显示全部 可查看将要导入的快捷键列表。

* 插件 – 如果您想导入在 Windsurf 中使用的扩展，请选择此项。 这些扩展程序将替换为 [JetBrains Marketplace](https://plugins.jetbrains.com/) 中的相应插件。 点击 显示全部 可查看将要安装的插件列表。 > **Note:** > 除了正在迁移的扩展程序外，还会安装 [AI 助手 插件](https://plugins.jetbrains.com/plugin/22282-jetbrains-ai-assistant)。 此插件为 JetBrains IDE 中的所有 [AI 功能](#migrate_from_windsurf_replicate_workflows_ai_features) 提供支持，包括代码补全、聊天和内联操作。

* 最近的项目 – 如果您想导入您曾在 Windsurf 中处理的项目，请选择此项。

将看到设置已成功导入的确认信息。

## 打开或创建您的第一个项目

开始在 IntelliJ IDEA 中工作时，系统会提示打开或创建项目。 这种项目优先的方法可启用 IDE 更好地理解上下文并提供更高级的编码辅助。

如果已从 Windsurf [导入项目](#import_settings_procedure)，它们将可立即打开。

或者，可以选择以下选项之一：

* `新建 | 项目` ：创建一个空项目或从现有模板生成项目。

* 打开 ：打开存储在您计算机上的项目。

* 克隆存储库 ：从像 GitHub 这样的 VCS 托管服务上的远程代码库获取现有项目。

打开项目后，您可以像往常一样开始编码。

## 安装扩展

在 JetBrains IDEs 中，我们将扩展称为  plugins 。 它们的工作方式与 Windsurf 中的扩展程序几乎相同，可用于扩展内置功能性并自定义 IDE。 若要浏览可用的插件，请按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，并导航到  `插件` 。

在 IntelliJ IDEA 中，开发所需的大多数工具和插件都已捆绑，可让您通过极少的额外配置开始或继续处理项目。

## 更改 UI 主题

IntelliJ IDEA 附带几个预定义主题，但也有多种自定义选项可供选择。 要探索它们，请按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置并选择   插件  ，然后搜索  `主题` 。

![自定义 IntelliJ IDEA：选择 UI 主题](https://resources.jetbrains.com/help/img/idea/2026.3/ij_migration_guide_customize_ij_select_theme.png)

然后，您可以返回编辑器查看已安装主题的外观。 请从主菜单中选择  `查看 | 快速切换方案`  或按 `Ctrl+`` (Windows), `⌃ `` (macOS), `⌃ `` (IntelliJ IDEA Classic (macOS)), `⌃ `` (macOS System Shortcuts), `Ctrl+`` (XWin), `Ctrl+`` (GNOME), `Ctrl+`` (KDE), `Ctrl+`` (Emacs), `Ctrl+`` (Sublime Text), `⌃ `` (Sublime Text (macOS)), `Ctrl+`` (Visual Studio), `Ctrl+`` (Visual Studio (macOS)), `Ctrl+`` (NetBeans), `Ctrl+`` (Eclipse), `⌃ `` (Eclipse (macOS)) 并选择  `主题` 。

## 配置快捷键

如果您以前从未使用过 IntelliJ IDEA 或其他 JetBrains IDE，习惯新的快捷键可能很有挑战性。 这里有一些可以帮助您的提示。

### 切换按键映射

如果您在第一次启动 IntelliJ IDEA 时未 [导入您的键映射设置](#import-settings)，您可以手动切换到它。

某些按键映射可能默认未与 IDE 捆绑，因此需要事先确保已安装相应插件。 为此，请转到  `设置 | 插件` ，选择   市场   选项卡，然后搜索想要使用的按键映射，例如  `VSCode Keymap` 。

安装后，请通过转到  `设置 | 键位图`  并从列表中选择   VSCode  ，将此按键映射设置为默认值。

![将 VS Code 键位图设置为默认](https://resources.jetbrains.com/help/img/idea/2026.3/ij_migration_guide_set_vscode_keymap.png)

### 学习 IntelliJ IDEA 快捷键

学习 IntelliJ IDEA 快捷键将非常有用，即使您之后决定切换到另一个 JetBrains IDE——几乎所有这些 IDE 中的快捷键都是相同的。 以下方法可以帮助您更快地学习它们：

* 记住 %instance% 最常用的快捷键 —— 在 `Shift` (Windows), `Shift` (macOS), `Shift` (IntelliJ IDEA Classic (macOS)), `Shift` (macOS System Shortcuts), `Shift` (XWin), `Shift` (GNOME), `Shift` (KDE), `Shift` (Emacs), `Shift` (Sublime Text), `Shift` (Sublime Text (macOS)), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS)) 或 搜索所有内容 。 可以使用它查找任何文件、操作、class 或符号，并在一个位置查看所有匹配项。

* [安装 Key Promoter X](https://plugins.jetbrains.com/plugin/9792-key-promoter-x) ——此扩展程序可帮助您在工作时学习基本快捷键。 当您在 IDE 内使用鼠标点击按钮时，Key Promoter X 会显示您可以使用的快捷键。

* 使用 %instance% 快捷键备忘单 – 您可以下载默认的 IntelliJ IDEA [键位图参考](https://resources.jetbrains.com/storage/products/intellij-idea/docs/IntelliJIDEA_ReferenceCard.pdf)，并将其打印成卡片。

## 复刻常见的 Windsurf 工作流程

来看看如何设置一些内容，使其像在 Windsurf 中一样工作。

### AI 功能

如果想在 IntelliJ IDEA 中通过 AI 驱动的功能增强工作流程，可以使用原生集成到 IDE 中的 JetBrains AI。 它同时包含 [AI 助手](https://www.jetbrains.com/zh-cn/ai-assistant/)（智能编码辅助工具）以及 [Junie](https://www.jetbrains.com/zh-cn/junie/)（可独立执行编码任务的 AI 编码智能体）。

AI 助手:

![](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.ml.llm.core.icons.aiAssistantColored.svg)   AI 助手   将 AI 驱动的编码代理和 AI 功能直接引入 IntelliJ IDEA。 可以使用内置代理、连接外部代理、通过额外工具扩展代理，并选择适合自己工作流程的模型和服务。 主要功能包括：

* 编码代理 —— 将多步任务委托给 [编码代理](https://www.jetbrains.com/zh-cn/help/ai-assistant/agents.html)，如 [Junie](https://www.jetbrains.com/zh-cn/help/ai-assistant/junie-agent.html)、 [Claude Agent](https://www.jetbrains.com/zh-cn/help/ai-assistant/claude-agent.html)、 [Codex](https://www.jetbrains.com/zh-cn/help/ai-assistant/codex-agent.html) 和 [GitHub Copilot](https://www.jetbrains.com/zh-cn/help/ai-assistant/copilot-agent.html)。 代理会方案工作、编辑文件、运行命令和测试，并报告进度，你可审核、保留或回滚更改。

* 通过 ACP 的外部代理 —— 可从精选注册表或自定义配置中连接支持 [Agent Client Protocol](https://www.jetbrains.com/zh-cn/help/ai-assistant/acp.html) 的任何代理，无需自定义集成。

* MCP 工具 —— 通过 [Model Context Protocol](https://www.jetbrains.com/zh-cn/help/ai-assistant/mcp.html) 用外部工具和数据源扩展代理，或将 IDE 作为 MCP 服务器暴露。

* 灵活设置 —— 可通过 [JetBrains AI 订阅](https://www.jetbrains.com/zh-cn/help/ai-assistant/jetbrains-ai-subscription.html) 开始、为第三方模型 [自带密钥](https://www.jetbrains.com/zh-cn/help/ai-assistant/bring-your-own-key-byok.html)、使用供应商账号 [授权代理](https://www.jetbrains.com/zh-cn/help/ai-assistant/activate-agents.html) 或运行 [本地模型](https://www.jetbrains.com/zh-cn/help/ai-assistant/use-custom-models.html)。 可以复用已有的 AI 订阅。

* 上下文感知 AI 聊天 —— 使用受支持的模型 [聊天](https://www.jetbrains.com/zh-cn/help/ai-assistant/ai-chat.html)，并询问有关项目的问题。 添加文件、文件夹、符号或提交作为上下文，然后切换至代理模式，在代码库中执行更改。

* 编辑器内编码辅助 —— 按你的代码风格和命名约定自动补全单行代码和整个代码块。 后续编辑建议会推荐你的后续编辑，并将你带到下一个可能需要更改的位置。

* 以及 [更多内容](https://www.jetbrains.com/zh-cn/help/ai-assistant/getting-started-with-ai-assistant.html)。

> **Note:**
> 默认情况下，  AI 助手  插件未捆绑，也未在 IntelliJ IDEA 中启用。 但是，如果您已 [导入](#import_settings_procedure)您的扩展， [AI 助手 插件](https://plugins.jetbrains.com/plugin/22282-jetbrains-ai-assistant)将自动安装 – 但在您手动启用之前，它将保持禁用状态。

Junie:

![Junie 徽标](https://resources.jetbrains.com/help/img/idea/2026.3/junie-logo.svg)   Junie   可独立执行任务，或与开发者协同工作。 例程任务可完全委托给 Junie，同时它也可以帮助处理更复杂的工作：

* 使用项目上下文和结构执行任务。

* 分析并搜索代码以查找相关信息。

* 使用 IDE 检查和校验进行代码编辑。

* 运行代码和测试以减少警告和错误。

* 更改后验证项目状态和测试结果。

* 支持通过变更审查和指导协作处理复杂任务。

* 以及 [更多](https://www.jetbrains.com/zh-cn/help/junie/get-started-with-junie.html)。

AI 功能可在新的订阅模式下使用，其中包含免费层级。 免费层级提供无限制代码补全、对本地模型的访问权限以及有限的基于云的功能。 可以选择升级到 AI Pro 或 AI Ultimate 层级以获得额外功能。

也可以在 IntelliJ IDEA 中使用 GitHub Copilot、Tabnine 和其他 AI 工具 – 在  `设置 | 插件`  中搜索相应的插件。 请注意，这些插件并非由 JetBrains 维护。

### 使用命令面板

随处搜索  可以替代 Windsurf 中的  命令面板 。 您可以使用它来搜索文件、操作、类或者符号。 所有匹配项均显示在一个位置。

要打开   随处搜索   对话框，请按 `Shift` (Windows), `Shift` (macOS), `Shift` (IntelliJ IDEA Classic (macOS)), `Shift` (macOS System Shortcuts), `Shift` (XWin), `Shift` (GNOME), `Shift` (KDE), `Shift` (Emacs), `Shift` (Sublime Text), `Shift` (Sublime Text (macOS)), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS)) 两次。

![定制 IntelliJ IDEA：命令面板](https://resources.jetbrains.com/help/img/idea/2026.3/ij_migration_customize_replicate_vsc_workflow_palette.png)

### 查找并替换

尽管 IntelliJ IDEA 的搜索和替换工作流程与 Windsurf 中的略有不同，但原理相同。 IntelliJ IDEA 允许您在 [特定文件](finding-and-replacing-text-in-file.html) 和 [整个项目](finding-and-replacing-text-in-project.html) 中查找和替换文本字符串。

首先，请在主菜单中导航至  `编辑｜查找` 。 选择  `查找` 以在当前文件中搜索或  `在文件中查找` 以在整个项目中搜索。 对于文本替换，请从同一个子菜单中选择  `替换`  或  `在文件中替换` 。

![自定义 IntelliJ IDEA：搜索和替换](https://resources.jetbrains.com/help/img/idea/2026.3/ij_migration_guide_customize_search_and_replace.png)

### 运行代码

Windsurf 允许从装订区域运行测试，但不能运行常规代码。 相比之下，IntelliJ IDEA 允许直接从装订区域运行代码、测试和其他配置。

![从侧边栏菜单运行](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置](run-debug-configuration.html) 中了解详情。

### 更改项目视图的默认设置

IntelliJ IDEA 有自己的   资源管理器  ，即   项目   工具窗口，其工作方式略有不同。 例如，您需要双击文件以在编辑器中打开它。 以下是更改默认设置以匹配 Windsurf 中习惯用法的方法：

您可以进入   项目   工具窗口设置，点击   行为  ，并选择以下任意或全部选项：

* 启用预览选项卡 ：在编辑器中的 项目 视图中预览您已选择的文件。 ![启用预览选项卡选项](https://resources.jetbrains.com/help/img/idea/2026.3/ij_enable_preview_tab_2.animated.gif)

* 点击打开文件 ：点击即可在编辑器中打开文件。 ![点击打开文件选项](https://resources.jetbrains.com/help/img/idea/2026.3/ij_open_files_with_single_click.animated.gif)

* 始终选择已打开的文件 ：在 项目 视图中自动选择当前打开的文件。 ![始终选择已打开的文件选项](https://resources.jetbrains.com/help/img/idea/2026.3/ij_always_select_opened_file.animated.gif)

## 如何获得支持

您可以查看 [我们的社区论坛](https://intellij-support.jetbrains.com/hc/en-us/community/topics/200382555-IntelliJ-IDEA-Users)，找到许多常见问题的答案，并向其他 IntelliJ IDEA 用户寻求帮助。

此外，如果您遇到问题，随时可以联系我们的支持团队。 要提交新工单，请从 IntelliJ IDEA 的主菜单中选择  `帮助 | 联系支持` 。 如需报告错误或请求新功能，请在 [此处](https://youtrack.jetbrains.com/issues/IDEA)创建新问题。 如需更多支持选项，请参阅 [支持与协助](getting-help.html)。

