从 Visual Studio Code 迁移
本指南适用于使用 Visual Studio Code 的 Python 开发人员，提供有关切换到 PyCharm 的信息。 它包括将 Visual Studio Code 项目导入到 PyCharm 所需的实际步骤，并简要说明了两个 IDE 之间最显著的差异，包括 用户界面、 通用工作流程和 快捷键。
将 Python 项目导入到 PyCharm
要导入在 Visual Studio Code 中创建的 Python 项目，只需在 PyCharm 中打开项目目录：
。配置 Python 解释器
PyCharm 会在源目录中搜索虚拟环境。 如果检测到，PyCharm 会建议将其用于项目或 配置一个新的解释器。
如果未检测到环境，PyCharm 会为项目设置系统解释器。
有关配置其他类型 Python 解释器的信息，请参阅以下部分之一：
安装所需的包
如果导入的项目不包含虚拟环境，您可以 配置一个新的 Python 解释器 ，然后为其安装所需的包：
对于 conda 和 virtualenv 环境，您可以 从 requirements.txt 安装所需的包。
对于 pipenv 环境，在创建环境时启用 从 Pipfile 安装软件包 复选框，或者 使用 Pipfile 创建环境。
对于 Poetry 环境，在创建环境时启用 从 pyproject.toml 安装包 复选框，或者 使用 pyproject.toml 创建环境。
导入运行配置
目前，PyCharm 不支持从 launch.json 导入运行/调试配置。 您需要为您的项目手动创建运行/调试配置：
转到 。 或者，在 运行 小部件中单击
，并从下拉菜单中选择 编辑配置(E)。
在 运行/调试配置 对话框中，点击工具栏上的
或按 Alt+Insert。 该列表显示运行/调试配置模板。 选择 Python。
根据 launch.json 中的配置指定运行/调试配置参数。
以下是 launch.json 中最常见的属性在 创建运行/调试配置时如何转换为参数的说明：
- 名称
运行/调试配置的名称。
在 名称 字段中指定它。
- type
运行/调试配置的类型。
在创建配置时选择相应的类型。
- 请求
指定是以调试模式启动程序还是将调试器附加到已运行的程序。
对于
"request": "launch"，您无需设置任何配置参数。如果您的配置包含
"request": "attach"，您无法在 PyCharm 中创建类似的运行/调试配置。 有关信息，请参阅 附加到进程。- 程序
配置启动时要运行的可执行文件或文件。
从下拉菜单中选择要运行的目标类型。 然后指定要执行的 Python 脚本路径或模块名称。
- cwd
用于查找依赖项和其他文件的当前工作目录。
在 工作目录 字段中指定它。
- 参数
运行或调试程序时传递的参数。
在 脚本参数 字段中指定参数。 在此字段中，您可以使用与 Visual Studio Code 配置文件中的 变量对应的宏。 有关信息，请参阅 向运行脚本传递参数。
- env
环境变量。
在 环境变量 字段中指定环境变量。 有关信息，请参阅 运行/调试配置。
- 环境文件
包含环境变量的 dotenv 文件路径。
在 “.env”文件的路径 字段中指定文件路径。 有关信息，请参阅 运行/调试配置。
- console
用于运行或调试程序的控制台。
在 PyCharm 中，代码通常在 运行 工具窗口中执行。 调试时，默认会打开 调试 控制台。 但是，您可能希望指定其他执行选项。 有关信息，请参阅 运行/调试配置。
- 仅我的代码
当省略或设置为
true时，调试仅限于用户编写的代码。在 PyCharm 中，您可以通过启用或禁用 不要单步进入库脚本 复选框在 中进行配置。 有关信息，请参阅 逐步进入。
用户界面差异
无工作区
启动 PyCharm 时您首先会注意到的是它没有 工作区的概念。 这意味着您一次只能处理一个项目。 在 Visual Studio Code中，您通常会有一组可能相互依赖的项目，而在 PyCharm 中，您只有一个由一组模块组成的项目。
如果您有几个不相关的项目，可以在单独的窗口中打开它们。
工具窗口
与 Visual Studio Code类似，在 PyCharm 中，您也有工具窗口。
项目 工具窗口
提交 工具窗口
运行 工具窗口
Python 控制台 工具窗口
数据库 工具窗口
要打开工具窗口，请点击相应的工具窗口按钮：
如果您不想用鼠标，您可以通过按下分配给它的快捷键随时切换到任何工具栏。 最重要的快捷键有：
项目： Alt+1
提交(I)： Alt+0
终端： Alt+F12
关于工具窗口的另一件事是，您可以拖动、固定、取消固定、附加和分离它们：
为帮助存储/恢复工具窗口布局，有几个有用的命令：
：将布局保存为新布局。
：重置当前布局中的更改。 （也可通过 Shift+F12 获取）
欲了解更多信息，请参阅 布局。
多个窗口
PyCharm 中的窗口管理与 Visual Studio Code略有不同。 您不能用一个项目打开多个窗口，但可以将任意数量的编辑器选项卡分离成独立的窗口。 要将标签移动到单独的窗口，请右键点击标签并选择 将标签页移动到新窗口 （或按 Shift+F4）。
始终选择已打开的文件
默认情况下，PyCharm 在切换编辑器选项卡时不会导航到 项目工具窗口 中的文件。 但是，您可以在 项目 工具窗口设置中启用它：
通用工作流程
无“保存”按钮
PyCharm 没有 保存 按钮。 由于在 PyCharm 中，您可以撤销重构并从 本地历史记录 恢复更改，因此每次都要求您保存更改是没有意义的。
然而，值得注意的是，物理保存到磁盘是由某些事件触发的，包括编译、关闭文件、切换焦点出 IDE 等等。 要更改自动保存行为，请按 Ctrl+Alt+S 打开设置，然后导航到 。 在 系统设置 页面，找到 自动保存 部分。
保存操作
如果您是经验丰富的 Visual Studio Code 用户，您应该熟悉 保存操作 ：保存时自动触发的操作，例如代码格式化、整理导入等。
PyCharm 还具有 保存操作 ，您可以在 中找到并启用这些操作。
提交时的操作
当您提交更改时，您可以自动运行各种操作。 例如，您可以自动运行测试、重新格式化代码、优化导入等。
快捷键
下表显示了顶级 Visual Studio Code操作（及其快捷键）如何映射到 PyCharm（您可能希望打印出来以便随时查看）。
Visual Studio Code | PyCharm | ||
|---|---|---|---|
动作 | 快捷键 | 动作 | 快捷键 |
触发建议 | Ctrl+Space 、 Ctrl+I ⌃ Space 、 ⌘ I | 基本补全 | Ctrl+Space |
转到文件 | Ctrl+P ⌘ P | 转到文件 | Ctrl+Shift+N |
显示命令面板 | Ctrl+Shift+P 、 F1 ⇧ ⌘ P 、 F1 | 查找操作 | Ctrl+Shift+A |
显示所有符号 | Ctrl+T ⌘ T | 转到符号 | Ctrl+Alt+Shift+N |
切换侧边栏可见性 | Ctrl+B ⌘ B | 隐藏所有工具窗口 | Ctrl+Shift+F12 |
向下/向上移动行 | Alt+上/下 ⌥ ↑／⌥ ↓ | 移动行 | Alt+Shift+Up/Alt+Shift+Down |
删除行 | Ctrl+Shift+K ⇧ ⌘ P | 删除行 | Ctrl+Y |
快速修复 | Ctrl+. ⌘ . | 显示快速修复/意图操作 | Alt+Enter |
导航编辑器组历史记录 | Ctrl+Shift+Tab ⌃ ⇧ ⇥ | 切换器 | Ctrl+Shift+Tab |
运行 | F5 | 运行 | Shift+F10 |
运行并调试 | Ctrl+Shift+D ⇧ ⌘ P | 调试 | Shift+F9 |
格式化文档 | Shift+Alt+F ⇧ ⌥ F | 重新设置代码格式 | Ctrl+Alt+L |
转到定义 | F12 | 前往声明或用法 | Ctrl+B |
查看定义 | Alt+F12 ⌥ F12 | 快速定义 | Ctrl+Shift+I |
显示引用 | Shift+F12 ⇧ F12 | 显示用法 | Ctrl+Alt+F7 |
查找所有引用 | Alt+Shift+F12 ⌥ ⇧ F12 | 查找用法 | Alt+F7 |
在文件中查找 | Ctrl+Shift+F ⇧ ⌘ F | 在文件中查找 | Ctrl+Shift+F |
重构 | Ctrl+Shift+R ⌃ ⇧ ⇥ | 重构此项 | Ctrl+Alt+Shift+T |
重命名符号 | F2 | 重命名 | Shift+F6 |
转到行 | Ctrl+G ⌃ G | 导航到行 | Ctrl+G |
查找下一个 | F3 ⌘ G | 查找下一个 | F3 |
返回 | Alt+Left ⌃ - | 后退 | Ctrl+Alt+Left |
前进 | Alt+Right ⌃ ⇧ - | 前进 | Ctrl+Alt+Right |
VSCode 键位图
如果您不想学习新的快捷键，可以安装 VSCode 键位图插件。 它会将 VSCode 键位图添加到 PyCharm，以便更接近地模拟 Visual Studio Code 的快捷键。
查找操作
当您不知道某个操作的快捷键时，尝试使用通过 查找操作 提供的 Ctrl+Shift+A 功能。 开始输入以按名称查找操作、查看其快捷键或调用它：
