开始使用

>最后修改时间：2022 年 5 月 23 日

PyCharm 是一个专用的 Python 集成开发环境 (IDE)，为 Python 开发人员提供了广泛的基本工具，紧密集成为高效的Python、Web和数据科学开发创建了一个方便的环境。

选择最适合您的 PyCharm

PyCharm 提供三个版本：

社区（免费和开源）：用于智能和智能 Python 开发，包括代码辅助、重构、可视化调试和版本控制集成。

专业（付费）：用于专业的 Python、Web 和数据科学开发，包括代码辅助、重构、可视化调试、版本控制集成、远程配置、部署、支持流行的 Web 框架，如 Django 和 Flask、数据库支持、科学工具（包括 Jupyter notebook 支持）、大数据工具。

Edu（免费和开源）：用于通过集成教育工具学习编程语言和相关技术。

有关详细信息，请参阅版本比较矩阵。

支持的语言

要开始使用 PyCharm 进行 Python 开发，您需要根据您的平台从python.org下载并安装 Python。

PyCharm 支持以下 Python 版本：

Python 2：版本 2.7

Python 3：从 3.6 版到 3.11 版

此外，在专业版中，可以开发 Django 、 Flask 和 Pyramid 应用程序。此外，它完全支持 HTML（包括 HTML5）、CSS、JavaScript 和 XML：这些语言通过插件捆绑在 IDE 中，并默认为您打开。还可以通过插件添加对其他语言和框架的支持（转到设置 | 插件或PyCharm | 首选项 | macOS 用户的插件，以了解更多信息或在首次 IDE 启动期间进行设置）。

支持的平台

PyCharm 是一个跨平台的 IDE，适用于 Windows、macOS 和 Linux。检查系统要求：

要求

最低限度

推荐的

内存

4 GB 可用 RAM

8 GB 总系统 RAM

中央处理器

任何现代 CPU

多核CPU。PyCharm 支持针对不同操作和进程的多线程处理，使其可以使用的 CPU 内核越多越快。

磁盘空间

2.5 GB 和另外 1 GB 用于缓存

具有至少 5 GB 可用空间的 SSD 驱动器

显示器分辨率

1024×768

1920×1080

操作系统

正式发布以下 64 位版本：

Microsoft Windows 8 或更高版本

macOS 10.14 或更高版本

任何支持 Gnome、KDE 或 Unity DE 的 Linux 发行版。PyCharm 不适用于某些不包含GLIBC 2.14 或更高版本的 Linux 发行版，例如 RHEL6 或 CentOS6。

不支持预发布版本。

最新的 64 位版本的 Windows、macOS 或 Linux（例如，Debian、Ubuntu 或 RHEL）

您可以使用Toolbox或独立安装来安装 PyCharm 。如果您在安装 PyCharm 时需要帮助，请参阅安装说明：安装 PyCharm

从 PyCharm 中的一个项目开始

你在 PyCharm 中所做的一切，都是在项目的上下文中进行的。它作为编码辅助、批量重构、编码风格一致性等的基础。您可以通过三个选项开始在 IDE 中处理项目：

打开现有项目

从版本控制中签出项目

创建一个新项目

打开现有项目

首先打开存储在计算机上的现有项目之一。您可以在欢迎屏幕上的最近项目列表中选择一个或单击打开：

否则，您可以为现有的源文件创建一个项目。选择“文件”菜单上的“打开”命令，并指定源文件所在的目录。然后 PyCharm 将根据您的源代码为您创建一个项目。有关详细信息，请参阅从现有源代码导入项目部分。

从版本控制中签出现有项目

您还可以从 VCS 存储或存储库下载源代码。选择 Git (GitHub)、Mercurial、Subversion、Perforce（仅专业版支持），然后输入您的凭据以访问存储。

然后，输入源路径并将存储库克隆到本地主机：

有关详细信息，请参阅版本控制部分。

创建一个新项目

要创建项目，请执行以下操作之一：

从主菜单中，选择文件 | 新项目

在欢迎屏幕上，单击新建项目

在 PyCharm Community 中，您只能创建 Python 项目，而在 PyCharm Professional 中，您有多种选择来创建 Web 框架项目。

社区和教育

专业的

在创建 Python 项目中查看更多详细信息。

创建新项目时，您需要指定 Python 解释器来执行项目中的 Python 代码。您需要在您的机器上至少安装一个 Python。

对于一个新项目，PyCharm 创建一个隔离的虚拟环境：venv、pipenv、poetry或Conda。在您工作时，您可以更改它或创建新的口译员。您还可以快速预览为解释器安装的包，并在Python 包工具窗口中添加新包。

有关更多详细信息，请参阅配置 Python 解释器。

环视四周

当您第一次启动 PyCharm 或没有打开的项目时，您会看到欢迎屏幕。它为您提供了进入 IDE 的主要入口点：创建或打开项目、从版本控制中签出项目、查看文档和配置 IDE。

打开项目时，您会看到主窗口分为几个逻辑区域。让我们花点时间看看这里的关键 UI 元素：

左侧的项目工具窗口显示您的项目文件。

右侧的编辑器，您实际编写代码的地方。它具有用于在打开的文件之间轻松导航的选项卡。

编辑器上方的导航栏还允许您快速运行和调试应用程序以及执行基本的VCS 操作。

Gutter是编辑器旁边的垂直条纹，显示了您拥有的断点，并提供了一种方便的方式来浏览代码层次结构，例如转到定义/声明。它还显示行号和每行 VCS 历史记录。

滚动条，在编辑器的右侧。PyCharm 不断监控您的代码质量，并始终在排水沟中显示其代码检查的结果：错误、警告等。右上角的指示器显示整个文件的代码检查的总体状态。

工具窗口是附加在工作区底部和侧面的专用窗口，提供对项目管理、源代码搜索和导航、与版本控制系统集成等典型任务的访问。

状态栏指示您的项目和整个 IDE 的状态，并显示各种警告和信息消息，如文件编码、行分隔符、检查配置文件等。它还提供对 Python 解释器设置的快速访问。

此外，在 PyCharm 窗口的左下角，在状态栏中，您会看到按钮

或

。此按钮切换工具窗口栏的显示。如果您将鼠标指针悬停在此按钮上，则会显示当前可用工具窗口的列表。

请参阅页面用户界面和工具窗口以了解有关显示或隐藏工具窗口的更多信息。

智能协助下的代码

当您创建了一个新项目或打开了一个现有项目时，就该开始编码了。

创建一个 Python 文件

在Project工具窗口中，选择项目根目录（通常为项目树中的根节点），右键单击，选择File | 新……

从上下文菜单中选择Python 文件选项，然后键入新文件名。

PyCharm 创建一个新的 Python 文件并打开它进行编辑。

PyCharm 会处理日常事务，以便您可以专注于重要的事情。使用以下编码功能创建无错误的应用程序，而不会浪费宝贵的时间。

代码完成

无论您使用什么类型的文件，代码完成都可以节省大量时间。

基本完成在您键入时工作并立即完成任何名称。

智能类型匹配完成会分析您当前工作的上下文，并根据该分析提供更准确的建议。

意图行动

PyCharm 会密切关注您当前正在做的事情并提出明智的建议，称为意图操作，以节省您更多的时间。用灯泡表示，意图操作让您可以对正确的代码应用自动更改（与为可能不正确的代码提供快速修复的代码检查相反）。您是否忘记在构造函数中添加一些参数和字段初始值设定项？PyCharm 没有问题。单击灯泡（或按Alt+Enter）并选择建议的选项之一：

可用意图操作的完整列表可在文件 |中找到。设置 | 编辑 | 意图或PyCharm | 偏好 | 编辑 | macOS 用户的意图。

保持代码整洁

PyCharm 会监控您的代码并尝试保持其准确和干净。它检测潜在的错误和问题，并建议快速修复它们。

每次 IDE 发现未使用的代码、无限循环以及许多其他可能需要您注意的事情时，您都会看到一个灯泡。单击它，或按Alt+Enter，应用修复。

生成一些代码

当您使用PyCharm 中提供的代码生成选项时，编写代码会变得更加容易和快捷。守则| 生成菜单Alt+Insert将帮助您从使用中创建符号，并建议覆盖或实现一些功能：

使用实时模板（选择代码 | 插入实时模板或按Ctrl+J）生成整个代码结构。您可以在“设置/首选项”对话框Ctrl+Alt+S（

如果您发现缺少对您的开发特别重要的东西，请使用您自己的扩展这组模板。此外，请考虑使用完整的结构快速包围您的代码（选择Code | Surround With或按Ctrl+Alt+T。例如，使用以下if语句：

找到你的路

当您的项目很大时，或者当您必须使用其他人的代码时，能够快速找到您正在寻找的内容并深入研究代码至关重要。这就是为什么 PyCharm 带有一组导航和搜索功能，可以帮助您在任何代码中找到自己的方式，无论代码多么复杂。

基本搜索

使用这些搜索工具，您可以在当前打开的文件 Ctrl+F或整个项目中查找和替换任何代码片段Ctrl+Shift+F。

搜索用途

要查找使用特定符号的位置，PyCharm 建议通过Find Usages 进行全面搜索Alt+F7：

项目导航

您可以通过查看文件结构及其导入或调用层次结构来了解很多信息：

此外，您可以导航到：

类、文件或符号的名称。

宣言 Ctrl+B。

基类/基函数 Ctrl+U。

左侧装订线中的图标也可以帮助您导航：

浏览时间线

记住您在项目中的所有活动，PyCharm 可以轻松地将您导航到最近的文件 Ctrl+E或最近更改的文件 Alt+Shift+C。

要查看更改历史记录，请尝试使用后退/前进导航 ( Ctrl+Alt+Left/ Ctrl+Alt+Right) 和/或转到最后编辑位置Ctrl+Shift+Backspace。

到处搜索

如果您大致了解要查找的内容，则始终可以使用现有导航功能之一找到相应的元素。但是，如果您想在每个角落和缝隙中寻找东西怎么办？答案是使用Search Everywhere！

要尝试它，请单击窗口右上角的放大镜按钮，或使用Double Shift调用它（按 Shift 两次）。

运行、调试和测试

现在，当您使用代码并发现可以用它做什么时，就该运行、调试和测试您的应用程序了。

跑

运行应用程序的最简单方法是在编辑器中单击鼠标右键，然后从上下文菜单中选择Run <name> ：

如果您的 Python 脚本包含该__main__子句，那么您可以单击

装订线中的按钮，然后选择所需的命令。

您可以在运行工具窗口中看到您的脚本执行情况。

当您使用 PyCharm 执行运行、调试或测试操作时，您始终会使用其参数基于现有的运行/调试配置之一启动一个进程。

当您第一次运行应用程序时，PyCharm 会自动创建临时运行/调试配置。您可以对其进行修改以指定或更改默认参数并将其保存为永久运行/调试配置。

在运行/调试配置中查看如何调整运行/调试配置。

调试

您的应用程序是否偶然发现运行时错误？要找出导致它的原因，您必须进行一些调试。PyCharm 支持所有平台上的调试器。

调试从放置程序执行将暂停的断点开始，因此您可以探索程序数据。只需单击要显示断点的行的间距。

要开始调试您的应用程序，请按Shift+F9。然后逐步执行程序（请参阅运行菜单或调试工具窗口中的可用选项），评估任意表达式，添加监视，并手动设置变量的值。

有关详细信息，请参阅调试部分。

测试

测试您的应用程序是一个好主意，PyCharm 可以帮助您尽可能简单地进行测试。

使用 PyCharm，您可以：

创建测试

创建特殊的测试运行/调试配置。

使用测试运行/调试配置直接从 IDE 运行和调试测试。

最后，最重要的是 - 您可以在运行工具窗口的测试运行器选项卡中浏览测试结果：

要了解这些数字，请阅读测试运行器选项卡部分。

PyCharm 支持所有主要的 Python 测试框架：

对于这些框架中的每一个，PyCharm 都提供了自己的运行/调试配置。

请参阅教程第 3 步。测试您的第一个 Python 应用程序和运行测试部分以了解详细信息。

使用PyCharm Professional，您可以远程运行、调试和测试您的 Python 代码。您可以将本地应用程序部署到某个远程服务器。要了解部署服务器，请参阅配置与 Web 服务器的同步部分。PyCharm Professional 还有助于比较本地和远程文件夹，并将本地副本与服务器上部署的副本同步。

将源代码置于版本控制之下

风险控制系统

如果您将源代码置于版本控制之下，您会很高兴知道 PyCharm 与许多流行的版本控制系统集成：Git（或 GitHub）、Mercurial、Perforce（仅在专业版中支持）、Subversion。要指定特定于特定 VCS 的凭据和任何设置，请转到设置 | 版本控制（或PyCharm | 首选项 | 版本控制，如果您是 macOS 用户）。

VCS 菜单为您提供有关可用命令的线索。例如，您可以从“本地更改”视图查看所做的更改、提交更改、创建更改列表等等：VCS | 显示更改（或只需按Alt+9）。另外，在编辑器上方的导航栏中找到一些 VCS 基本命令：

有关详细信息，请参阅版本控制部分。

地方历史

除了传统的版本控制，还可以使用本地历史。借助 Local History，PyCharm 会自动跟踪您对源代码所做的更改、重构的结果等

本地历史记录始终启用。要查看文件或文件夹，请通过选择VCS | 调出本地历史。地方历史 | 显示历史。您可以在此处查看更改、还原更改或创建补丁。

处理数据

PyCharm 有一个交互式 Python 控制台，可以通过动态语法检查对数据执行智能操作，包括检查、大括号和引号匹配，当然还有代码完成。您还可以从对 Anaconda 的内置支持中受益。

使用PyCharm Professional，您可以分析和可视化各种科学和统计数据。Jupyter Notebook 集成支持编辑、执行和调试笔记本源代码并检查执行输出，包括流数据、图像和其他媒体。

通过安装在 PyCharm 中的R 插件，您可以使用 R 语言执行各种统计计算，并使用编码辅助、可视化调试、智能运行和预览工具以及其他流行的 IDE 功能。

您可能已经注意到，创建各种类型的项目（例如 Django）需要数据源。您也很有可能将 SQL 语句注入源代码。

PyCharm Professional不允许您创建数据库，但提供了管理和查询它们的工具。一旦您被授予访问某个数据库的权限，您就可以在 PyCharm 中配置一个或多个数据源，以反映数据库的结构并存储数据库访问凭据。基于此信息，PyCharm 建立与数据库的连接并提供检索或更改其中包含的信息的能力。

数据库窗口（查看|工具窗口|数据库）提供对数据库的访问。此工具窗口允许您使用数据库。它允许您查看和修改数据库中的数据结构，并执行其他相关任务。

有关详细信息，请参阅数据库工具和 SQL。

自定义您的环境

随意调整 IDE，使其完美地满足您的需求，并尽可能地提供帮助和舒适。转到文件 | 设置（PyCharm | macOS 用户的首选项）以查看可用自定义选项的列表。

外貌

编辑

文件 |下可用的许多页面设置 | 编辑器（PyCharm | Preferences | macOS 用户的编辑器）帮助您调整编辑器行为的各个方面。这里提供了很多选项，从常规设置（如拖放启用、滚动配置等）到每种可用语言和用例的颜色配置、选项卡和代码折叠设置，再到代码完成行为甚至后缀模板。

有关详细信息，请参阅配置 PyCharm 设置部分。

代码风格

可以在File |下为每种语言定义代码样式设置 | 编辑 | 代码样式（PyCharm | 首选项 | 编辑器 | macOS 用户的代码样式）。您还可以创建和保存自己的编码风格方案。

请参阅配置代码样式和代码质量帮助提示和技巧，或如何使您的代码看起来漂亮？详情。

键盘映射