从 Windsurf 迁移
Windsurf 基于高度可自定义且极简的设置构建,允许用户配置环境以适配特定工作流。
PyCharm 提供开箱即用的环境,从而带来不同的使用体验。 其内置的开发者工具集、深度语言支持以及高级 AI 功能从一开始即可使用,最大限度地减少额外配置的需求。
有关 PyCharm 的关键功能列表,请访问 功能概览 页面。
导入设置
首次启动您的 PyCharm 时,您将看到 导入设置 对话框,其中包含在您的计算机上找到的其他 IDE 的设置列表。
选择 Windsurf 以导入设置。

选择要导入的设置,并点击 导入设置。

UI 主题 – 如果要导入主题设置,请选择此项。
键位映射 – 如果要导入键盘快捷键,请选择此项。 点击 显示全部 以查看将要导入的快捷键列表。
插件 – 如果要导入您在 Windsurf 中使用的扩展,请选择此项。 这些扩展将替换为来自 JetBrains 市场 的相应插件。 点击 显示全部 以查看将要安装的插件列表。
最近的项目 – 如果要导入您在 Windsurf 中处理过的项目,请选择此项。
您将看到已成功导入设置的确认信息。
打开或创建您的第一个项目
在 PyCharm 中开始工作时,系统会提示您打开或创建项目。 这种以项目为先的方法使 IDE 能够更好地理解上下文,并提供更高级的编码辅助。
如果您已从 Windsurf 导入您的项目 ,则可以立即打开它们。

或者,您可以选择以下选项之一:
新建笔记本 :创建 Jupyter 笔记本。
新建脚本 :创建 Python 文件。
新建项目 :创建空项目,或从现有模板生成项目。
打开 :打开存储在您计算机上的项目。
克隆存储库 :从 GitHub 等 VCS 托管服务上的远程存储库获取现有项目。
打开项目后,您即可照常开始编码。
安装扩展
在 JetBrains IDE 中,我们将扩展称为 插件。 它们的工作方式与 Windsurf 中的扩展大体相同,允许您扩展内置功能并自定义您的 IDE。 要浏览可用插件,请按 Ctrl+Alt+S 打开设置,并导航到 。 可用插件位于 插件市场 选项卡下。
更改 UI 主题
PyCharm 自带几个预定义主题,但也提供多种自定义选项可供选择。 要进行探索,请按 Ctrl+Alt+S 打开设置并选择 插件。 在 插件市场 选项卡中,搜索 Theme。
然后,您可以返回编辑器,查看已安装主题的外观。 从主菜单中选择 ,或按 Ctrl+` 并选择 。 在此处,您可以预览所有可用的主题。
配置快捷键
如果您之前从未使用过 PyCharm 或其他 JetBrains IDE,适应新的快捷键可能具有一定难度。 以下是一些可帮助您的提示。
切换键位映射
如果您在首次启动 PyCharm 时未 导入您的键位映射设置 ,您可以手动切换到该键位映射。
某些键位映射可能默认未随 IDE 一起提供,因此您需要确保事先安装了相应的插件。 为此,请转到 ,选择 Marketplace 选项卡,并搜索您想要使用的键位映射,例如 VSCode Keymap。
安装完成后,请转到 ,并从列表中选择 VSCode ,将此键位映射设为默认。
学习 PyCharm 快捷键
即使您之后决定切换到其他 JetBrains IDE,学习 PyCharm 的快捷键也会大有裨益——几乎所有 JetBrains IDE 的快捷键都是相同的。 以下内容可帮助您更快地掌握它们:
记住 PyCharm 最通用的快捷键 – 连按 Shift ,或使用 随处搜索。 您可以使用它查找任意文件、操作、类 或符号,并在一个位置查看所有匹配项。
安装 Key Promoter X – 此扩展可帮助您在工作时学习常用快捷键。 当您在 IDE 中使用鼠标点击某个按钮时,Key Promoter X 会显示您本可以使用的快捷键。
使用 PyCharm 快捷键速查表 – 您可以下载 PyCharm 的默认键位映射,并将其打印成卡片。
复现 Windsurf 中常见的工作流
让我们看看如何将一些设置调整为与 Windsurf 中相同的工作方式。
AI 功能
如果您希望在 PyCharm 中借助 AI 功能增强您的工作流,您可以使用 JetBrains AI,它已原生集成到 IDE 中。 它同时包括 AI Assistant (智能编码辅助工具)和 Junie (可独立执行编码任务的 AI 编码代理)。
AI Assistant 通过直接集成到您的 IDE 的智能功能来增强您的开发工作流。 主要功能包括:
代码补全——自动补全单行和整段代码,确保遵循您的编码风格和命名约定。
下一步编辑建议——获取对您代码下一步可能修改的建议。 快速应用建议并跳转到可能需要更改的下一个位置,在整个文件范围内更新相关代码。
AI Chat(代理模式)——与受支持的语言模型进行聊天,询问有关您项目的问题,或迭代完成任务。 切换到代理模式以执行更复杂的操作,例如实施修复、重构代码、生成测试等。
上下文管理——添加文件、文件夹、图像、符号、提交或其他项目,为 AI Assistant 提供与您的问题相关的更多上下文。
响应处理——查看并应用 AI 建议的更改。 直接在 AI Chat 中修改单个或多个文件、应用代码片段或运行终端命令。
云端 LLM 支持——选择您偏好的 AI 模型在 AI Chat 中使用。 可从 Google Gemini、OpenAI 和 Anthropic 等云提供商中进行选择。
使用本地模型——设置第三方提供的自定义本地模型,并将其用于 AI Assistant 功能,例如代码补全、在编辑器中生成代码或生成提交消息。
以及 更多。
Junie 可以独立执行任务,或与开发人员协同工作。 常规任务可以完全交由 Junie 处理,同时它也可以协助完成更复杂的工作:
基于项目的上下文和结构执行任务。
分析并搜索代码以查找相关信息。
利用 IDE 的检查和校验进行代码编辑。
运行代码和测试,以减少警告和错误。
在更改后验证项目状态和测试结果。
支持通过变更审查和指导协作处理复杂任务。
以及 更多。
AI 功能采用新的订阅模式提供,其中包含免费层。 免费层提供无限制的代码补全、访问本地模型,以及有限的云端功能。 您可以选择升级到 AI Pro 或 AI Ultimate 层,以获得更多功能。
激活 AI Assistant
请确保您已使用有效的 JetBrains 账户 登录。
按照 AI Assistant 帮助 中的说明激活您的许可证。
您还可以在 PyCharm 中使用 GitHub Copilot、Tabnine 等 AI 工具——请在 设置 | 插件 中的 插件市场 选项卡中搜索相应插件。 请注意,这些插件并非由 JetBrains 维护。
使用命令面板
随处搜索 可替代 Windsurf 中的 命令面板。 您可以使用它搜索文件、操作、类或符号。 所有匹配项都会在同一位置显示。
要打开 随处搜索 对话框,请连续按两次 Shift。
查找和替换
尽管 PyCharm 的查找和替换工作流与 Windsurf 略有不同,但其原理相同。 PyCharm 让您可以在 特定文件 与 整个项目 中查找与替换文本字符串。
首先,在主菜单中转到 。 选择 在当前文件中搜索,或选择 在整个项目中搜索。 要进行文本替换,请在同一子菜单中选择 或 。
运行代码
Windsurf 允许您从装订区域运行测试,但无法运行常规代码。 相比之下,PyCharm 允许您直接从标记栏运行代码、测试及其他配置。
PyCharm 提供了 多种运行代码的方式。 在底层,它们都依赖于 运行/调试配置。 通过创建自定义的运行/调试配置,您将拥有最大的自由度与灵活性。 了解详情,请参阅 运行/调试配置。
更改项目视图的默认设置
PyCharm 有自己的 资源管理器 ,即 项目 工具窗口,其工作方式略有不同。 例如,您需要双击文件才能在编辑器中将其打开。 以下是将默认设置更改为与您在 Windsurf 中习惯的方式一致的方法:
您可以转到 项目 工具窗口的设置,点击 行为 ,并选择以下任一或全部选项:
启用预览选项卡 :在编辑器中预览您在 项目 视图中选择的文件。
点击打开文件 :点击一次即可在编辑器中打开文件。
始终选中已打开的文件 :在 项目 视图中自动选择当前打开的文件。
如何获取支持
您可以查找许多常见问题的答案,并向其他 PyCharm 用户寻求帮助。
此外,如果遇到困难,您随时可以联系我们的支持团队。 要提交新的工单,请在 PyCharm 的主菜单中选择 。 要报告缺陷或请求新功能,请在 此处 创建新议题。