PyCharm 2019.2帮助

入门

PyCharm是专用的Python集成开发环境(IDE),为Python开发人员提供了广泛的基本工具,它们紧密集成在一起,从而为生产性Python,Web和数据科学开发创造了便利的环境。

认识PyCharm

PyCharm版本

PyCharm提供三种版本: 专业版社区版教育版(Edu)CommunityEdu版本是开源项目,它们是免费的,但功能较少。PyCharm Edu提供课程并帮助您学习Python编程。专业版是商业版本,并提供了一套出色的工具和功能。有关详细信息,请参见版本比较矩阵

支持的语言

使用PyCharm,您可以使用Python开发应用程序:

  • Python 2: 2.7版

  • Python 3:从3.5版到3.8版

另外,在专业版中,可以开发Django,Flask和Pyramid应用程序。此外,它完全支持HTML(包括HTML5),CSS,JavaScript和XML:这些语言通过插件捆绑在IDE中,并且默认情况下会为您打开。还可以通过插件添加对其他语言和框架的支持(转到macOS用户的设置|插件PyCharm |首选项|插件 ,以查找更多信息或在第一次IDE启动时对其进行设置)。

支持平台

PyCharm是可在Windows,macOS和Linux上运行的跨平台IDE。检查系统要求:

需求

最低要求

推荐的

内存

4 GB的可用RAM

8 GB的总系统RAM

磁盘空间

2.5 GB,另外1 GB用于缓存

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

显示器分辨率

1024x768

1920×1080

操作系统

正式发布的以下64位版本:

  • Microsoft Windows 7 SP1或更高版本

  • macOS 10.11或更高版本

  • 任何支持Gnome,KDE或Unity DE的Linux发行版

不支持预发行版本。

Windows,macOS或Linux的最新64位版本(例如,Debian,Ubuntu或RHEL)

如果您在安装PyCharm时需要帮助,请参阅安装说明: 安装PyCharm

通常,要开始使用PyCharm在Python中进行开发,您需要下载,安装并启动PyCharm(取决于您的平台)。

步骤1。在PyCharm中打开/创建项目

为什么需要一个项目?

您在PyCharm中所做的一切都是在项目环境中完成的。它用作编码辅助,批量重构,编码样式一致性等的基础。

您可以使用三个选项来开始在IDE内的项目上工作:

打开一个现有项目

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

欢迎画面

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

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

您也可以从VCS存储或存储库下载源 。选择Git(GitHub),Mercurial,Subversion,Perforce(仅在专业版中受支持),然后输入您的凭据以访问存储。

然后,输入源的路径并将存储库克隆到本地主机:

克隆存储库

有关详细信息,请参见“ 版本控制 ”部分。

从头开始创建项目

  1. 要创建一个项目,请执行以下任一操作:

    • 在主菜单中,选择“ 文件” |“文件”。新项目

    • 在“ 欢迎”屏幕上 ,单击“ 创建新项目”。

    “新建项目”对话框打开。

  2. 在“ 新建项目”对话框中,指定项目名称及其位置。对话框可能因PyCharm版本而异。

    创建一个新项目

    创建PyCharm有助于实施新项目

  3. 接下来,点击展开节点单击相应的单选按钮以展开“ 项目解释器”节点,并选择新环境或现有解释器。以下步骤取决于您的选择:

    • 使用新环境 :如果已选择此选项,请选择用于创建虚拟环境的工具。为此,请单击列表,然后选择VirtualenvPipenvConda

      接下来,指定新虚拟环境的位置和基本解释器。如有必要,请单击“ 继承全局站点包”“对所有项目可用”复选框。

    • 现有解释器 :如果选择了此选项,请从列表中选择所需的解释器,或者(如果找不到所需的解释器),请单击打开并选择翻译。有关详细信息,请参见配置Python解释器

将创建新项目:

样本Python项目

创建一个Python文件

在“ 项目工具”窗口中选择项目根目录,然后选择“ 文件” |“文件”。从主菜单新建...或按Alt+Insert

创建一个Python文件

从弹出菜单中选择选项Python文件 ,然后键入新文件名。

创建一个新的Python文件

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

新的Python文件

配置项目解释器

创建新项目时,需要添加和配置项目解释器。 在“ 设置/首选项”对话框中( Ctrl+Alt+S ),点击项目解释器 ,然后点击添加项目解释器 ,然后选择添加...。根据项目的具体情况,您可以选择:

第2步。环视四周

首次启动PyCharm或没有打开的项目时,您会看到“ 欢迎”屏幕 。它为您提供了IDE的主要入口点: 创建或打开项目 ,从版本控制中签出项目, 查看文档以及配置IDE

打开项目后,您会看到主窗口分为几个逻辑区域。让我们花点时间在此处查看关键的UI元素:

项目视图,编辑器和工具窗口
  1. 左侧的项目视图显示您的项目文件。

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

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

  4. 左边的装订线 ,即编辑器旁边的垂直条纹,显示了您的断点,并提供了一种方便的方法来浏览代码层次结构,例如转到定义/声明。它还显示行号和每行VCS历史记录。

  5. 右侧装订线,位于编辑器的右侧。PyCharm会持续监控您的代码质量,并始终在正确的装订线中显示其代码检查的结果:错误,警告等。右上角的指示器显示整个文件的代码检查的总体状态。

  6. 工具窗口是连接到工作区底部和侧面的专用窗口,可用于访问典型任务,例如项目管理,源代码搜索和导航,与版本控制系统的集成等。

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

另外,在PyCharm窗口的左下角的状态栏中,您会看到按钮显示工具窗口栏要么隐藏工具窗口栏 。此按钮切换工具窗口栏的显示。如果将鼠标指针悬停在此按钮上,则会显示当前可用工具窗口的列表:

工具窗口快速访问

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

第三步自定义您的环境

随意调整IDE ,使其完全适合您的需求,并且尽可能地有用和舒适。转到文件|设置 (macOS用户的PyCharm |首选项 )以查看可用的自定义选项列表。

出现

要调整的第一件事是一般的“外观”。转到文件|设置|外观和行为外观 (macOS用户的PyCharm |首选项|外观和行为|外观 )以选择IDE主题 :默认的浅色主题;如果您喜欢较暗的设置,则选择Darcula。

编辑

文件|文件”下可用的许多页面设置|编辑器 (适用于macOS用户的PyCharm |首选项|编辑器 )可帮助您调整编辑器行为的各个方面。这里有许多选项,从常规设置(如启用“拖放”,滚动配置等)到每种可用语言和用例的颜色配置,到制表符和代码折叠设置,再到代码完成行为,甚至是后缀模板。

有关详细信息,请参阅“ 配置项目和IDE设置”部分。

代码风格

可以在文件|文件中为每种语言定义代码样式 。设置|编辑器代码样式 (macOS用户的PyCharm |首选项|编辑器|代码样式 )。您还可以创建并保存自己的编码样式方案。

代码样式设置

请参阅配置代码样式代码质量帮助提示和技巧,或如何使代码看起来更漂亮? 有关详细信息。

按键图

PyCharm使用以键盘为中心的方法,这意味着IDE中几乎所有可能的操作都映射到键盘快捷键。

您使用的一组键盘快捷键是您最亲密的习惯之一-您的手指“记住”某些按键组合,改变这种习惯说起来容易做起来难。PyCharm为您提供了默认的键盘映射(从主菜单中选择“ 帮助” |“键盘映射参考 ”),使您的编码真正高效且便捷。但是,您始终可以将其更改File | File。设置|键盘映射 (适用于macOS用户的PyCharm |首选项|键盘映射 )。

还有一些预定义的键盘映射(例如Emacs,Visual Studio,Eclipse,NetBeans等),您还可以基于现有键盘映射创建自己的键盘映射。

如果您觉得vi / Vim的工作效率最高,那么仿真模式将为您提供两全其美的体验。在IDE中启用IdeaVim插件,然后选择vim键盘映射。

有关详细信息,请参阅“ 配置键盘快捷键 ”部分。

第四步。借助智能协助进行编码

PyCharm负责日常工作,因此您可以专注于重要工作。使用以下编码功能来创建无错误的应用程序,而不会浪费宝贵的时间。

代码完成

无论您使用的是哪种文件类型, 代码完成都可以节省大量时间。

基本完成功能在您键入时起作用,并立即完成任何名称。

智能类型完成功能会分析您当前正在使用的上下文,并根据该分析提供更准确的建议。

智能代码完成

意向动作

PyCharm会密切关注您当前正在做的事情,并提出明智的建议(称为意图行动) ,以节省更多时间。用灯泡表示,意图操作使您可以对正确的代码进行自动更改(与为可能不正确的代码提供快速修复的代码检查相反)。您是否忘记向构造函数添加一些参数和字段初始化程序?PyCharm没问题。点击灯泡(或按Alt+Enter ),然后选择建议的选项之一:

意向行动

可用意向动作的完整列表可在“ 文件” |“文件”中找到。 设置|编辑器意图PyCharm |首选项|编辑器 macOS用户的意图

第五步保持代码整洁

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

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

可用检查的完整列表可在“设置” |“设置”下找到。编辑器检查 (或macOS用户的PyCharm |首选项|编辑器|检查 )。禁用其中一些,或启用其他功能,并调整每次检查的严重性。您可以决定将其视为错误还是警告。

第六步生成一些代码

使用PyCharm中可用的代码生成选项时,编写代码会变得更加轻松快捷。守则|产生选单Alt+Insert将帮助您根据用法创建符号,并建议您覆盖/实现某些功能:

产生程式码

使用实时模板(选择代码|插入实时模板或按Ctrl+J )以生成整个代码结构。您可以浏览可用的实时模板在“ 设置/首选项”对话框中( Ctrl+Alt+S )(如果您是macOS用户,则设置|编辑器|实时模板PyCharm |首选项|编辑器|实时模板 )。

如果发现缺少对开发特别重要的内容,请使用自己的模板扩展这组模板。另外,还要考虑迅速周边有完整的结构代码(选择代码|的环绕或按Ctrl+Alt+T 。例如,选择一个if声明:

环绕声代码

您将获得:

包围的代码

步骤7找到你的方式

当您的项目很大时,或者当您必须使用他人的代码时,至关重要的是能够快速找到所需的内容并深入研究代码。这就是PyCharm带有一组导航搜索功能的原因,无论它们有多复杂,它都可以帮助您找到任何代码。

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

搜索用法

为了找到使用特定符号的位置,PyCharm建议通过“ 查找用法”进行全面搜索Alt+F7

查找用法

项目导航

您可以通过查看文件结构及其导入或调用层次结构了解很多内容:

档案结构

另外,您可以导航到:

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

浏览时间轴

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

要查看更改的历史记录,请尝试使用“后退/前进”导航( Ctrl+Alt+Left / Ctrl+Alt+Right )和/或转到上一个编辑位置Ctrl+Shift+Backspace

随处搜寻

如果您对所要查找的内容有大致了解,则可以始终使用现有的导航功能之一找到相应的元素。但是,如果您真的想在每个角落都找些东西怎么办?答案是使用“无处不在搜索”

若要尝试,请单击窗口右上角的放大镜按钮,或使用Double Shift (两次按Shift)调用它。

搜索所有窗口

步骤8运行,调试和测试

现在,当您使用代码并发现可以使用它的功能时,就可以运行,调试和测试您的应用了。

运行应用程序的最简单方法是在编辑器中右键单击其背景,然后选择“运行”。 从上下文菜单中:

运行代码

如果您的Python脚本包含__main__子句,则可以单击运行图标按钮,然后选择所需的命令。

运行配置

当您使用PyCharm执行运行,调试或测试操作时,始终使用其参数根据现有运行/调试配置之一启动进程。

首次运行应用程序时,PyCharm会自动创建临时的“运行/调试”配置 。您可以修改它以指定或更改默认参数,并将其另存为永久的“运行/调试”配置。

打开“ 运行/调试配置”对话框。编辑配置以查看所有可用选项。例如,如果要在构建阶段之前/之后运行一些脚本,则可以通过创建外部工具轻松地做到这一点:

运行/调试配置

要运行配置,请按Shift+F10

除错

您的应用程序是否偶然遇到运行时错误?要找出造成问题的原因,您必须进行一些调试。PyCharm在所有平台上都支持调试器。

调试从放置要暂停程序执行的断点开始,因此您可以浏览程序数据。只需单击要在其中出现断点的行的左装订线即可。

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

调试工具窗口

有关详细信息,请参见调试部分。

测试

测试您的应用程序是个好主意,PyCharm会帮助您做到尽可能简单。

使用PyCharm,您可以:

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

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

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

    运行工具窗口中的测试运行器

要了解数字,请阅读“ 测试运行器选项卡”部分。

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

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

请参阅教程步骤3。测试您的第一个Python应用程序 ,有关详细信息,请参见“ 执行测试”部分。

步骤9。将您的源代码置于版本控制下

VCS

如果您将源代码保持在版本控制下,您将很高兴知道PyCharm与许多流行的版本控制系统集成:Git(或GitHub),Mercurial,Perforce(仅在专业版中受支持),Subversion。要指定凭据和特定于特定VCS的任何设置,请转至“设置” |“设置”。版本控制 (如果您是macOS用户,则为PyCharm |首选项|版本控制 )。

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

版本控制系统

有关详细信息,请参见“ 版本控制 ”部分。

当地历史

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

始终启用本地历史记录。要查看该文件或文件夹,选择VCS弹出本地历史 |当地历史|显示历史 。您可以在此处查看更改,还原更改或创建补丁。

第十步远程开发

借助PyCharm,您可以使用位于远程的项目解释器。 在“ 设置/首选项”对话框中( Ctrl+Alt+S ),选择页面Project Interpreter ,然后单击口译员设置 ),然后选择添加

添加翻译

您可以添加和配置以下远程解释器:

首先,您可以将本地应用程序部署到某个远程服务器。要了解有关部署服务器的信息,请参阅“ 配置与Web服务器的同步 ”部分。部署应用程序后,您可以远程运行,调试和测试它。PyCharm还可以帮助您比较本地和远程文件夹,并使本地副本与服务器上部署的副本同步

步骤11资料库

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

PyCharm不允许您创建数据库,但是提供了管理和查询数据库的功能。授予您对特定数据库的访问权限后,您可以在PyCharm中配置一个或多个数据源,以反映数据库的结构并存储数据库访问凭据。根据此信息,PyCharm会建立与数据库的连接,并提供检索或更改其中包含的信息的能力。

通过数据库工具窗口视图|工具窗口|数据库 )提供对数据库的访问。该工具窗口使您可以使用数据库。它使您可以查看和修改数据库中的数据结构,以及执行其他关联的任务。

数据库工具窗口

有关详细信息,请参见数据库工具和SQL

步骤12而已!继续快乐地发展!

我们希望对PyCharm基本功能的简要概述能使您快速入门。有许多重要功能使开发人员的生活更轻松,更有趣,并且源代码更加整洁。现在就采取这些最初的几个步骤,然后在您认为合适的时候进行更深入的研究。享受PyCharm!

如有任何疑问,请访问我们的论坛Twitter博客 ,您可以在其中找到新闻,更新以及有用的提示和技巧。另外,请随时向我们的支持团队或PyCharm 问题跟踪器报告任何问题。

上次修改时间:2019年11月6日