从 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 中最常见的属性在 创建运行/调试配置 时如何转换为参数的说明：
- 名称
-
运行/调试配置的名称。
在 名称 字段中指定它。
- 类型
-
运行/调试配置的类型。
在创建配置时选择相应的类型。
- 请求
-
指定是以调试模式启动程序还是将调试器附加到已运行的程序。
对于
"request": "launch"，您无需设置任何配置参数。如果您的配置包含
"request": "attach"，您无法在 PyCharm 中创建类似的运行/调试配置。 有关信息，请参阅 附加到进程 。 - 程序
-
配置启动时要运行的可执行文件或文件。
从下拉菜单中选择要运行的目标类型。 然后指定要执行的 Python 脚本路径或模块名称。
- 当前工作目录
-
用于查找依赖项和其他文件的当前工作目录。
在 工作目录 字段中指定它。
- 参数
-
运行或调试程序时传递的参数。
在 脚本形参 字段中指定参数。 在此字段中，您可以使用与 Visual Studio Code 配置文件中的 变量 对应的宏。 有关信息，请参阅 向运行脚本传递参数 。
- 环境变量
-
环境变量。
在 环境变量 字段中指定环境变量。 有关信息，请参阅 运行/调试配置 。
- 环境文件
-
包含环境变量的 dotenv 文件路径。
在 “.env”文件的路径 字段中指定文件路径。 有关信息，请参阅 运行/调试配置 。
- 控制台
-
用于运行或调试程序的控制台。
在 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 |
基本补全 |
Ctrl+Space |
|
转到文件 |
Ctrl+P |
转到文件 |
Ctrl+Shift+N |
|
显示命令面板 |
Ctrl+Shift+P ⇧ ⌘ P |
查找操作 |
Ctrl+Shift+A |
|
显示所有符号 |
Ctrl+T |
转到符号 |
Ctrl+Alt+Shift+N |
|
切换侧边栏可见性 |
Ctrl+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 |
|
运行 |
|
运行 |
Shift+F10 |
|
运行并调试 |
Ctrl+Shift+D ⇧ ⌘ P |
调试 |
Shift+F9 |
|
格式化文档 |
Shift+Alt+F ⇧ ⌥ F |
重新设置代码格式 |
Ctrl+Alt+L |
|
转到定义 |
|
前往声明或用法 |
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 |
|
重命名符号 |
|
收藏列表的新名称 |
Shift+F6 |
|
转到行 |
Ctrl+G |
导航到行 |
Ctrl+G |
|
查找下一个 |
|
查找下一个 |
F3 |
|
返回 |
Alt+Left |
||