Python IDE strongest detailed Guide!

zuòzhě | Jahongir Rahmonov

Source | Almost Human

Almost Human compilation, participation: devil

PyCharm is a Python IDE, programmers can help save time and improve productivity. So specifically how to use it? This article has been introduced one by one from PyCharm to install plug-in, external tools, such as Pro features, hoping to help to you.

Before I did not introduce systematically over PyCharm, how to configure the environment, how DeBug, how to synchronize GitHub and so may have been groping through experience or learn. After this article, we will not provide a very comprehensive guide, but will introduce some of the most important PyCharm capacity to understand these, we need to be more specific later learned in practice.

Readers should be well aware of PyCharm JetBrains development, and it is almost the most commonly used Python IDE. PyCharm can save us a lot of time, it is able to manage the code, and to complete a number of other tasks, such as debug and visualization.

This article explains:

PyCharm installation
Write code in PyCharm
In PyCharm run code
Test and debug code in the PyCharm
To edit an existing project in the PyCharm
Search and navigate in PyCharm
Version control in the PyCharm
Using the plug-in and external tools PyCharm
Use PyCharm Professional features, such as Django and support scientific models

This article assumes that you are familiar with Python development, and the computer in a version of Python installed. This tutorial will use the Python 3.6 version, screenshots and demo are from macOS system. Since PyCharm runs on all major platforms, readers in other systems will see a slightly different UI elements, may need to adjust some commands.

PyCharm installation

This article will use PyCharm Community Edition 2019.1 version, which is free and can be used on all major platforms. Only the last part of "PyCharm Professional features" using PyCharm Professional Edition 2019.1 version.

Recommended JetBrains Toolbox App install PyCharm. Using this App, you can install different versions of the same product or JetBrains products, and update, if necessary, delete any rollback and easy tool. You can also quickly open any project in the IDE and the right version.

Toolbox App Installation Guide, see JetBrains official document: https: //www.jetbrains.com/help/pycharm/installation-guide.html#toolbox.
The App will provide the appropriate installation instructions depending on your operating system. If it can not can not accurately identify the system, you can find the right system in the drop-down list in the upper right corner.

After successful installation, start the app and accept the user agreement. Under Tools Options, you can see a list of available products. To find PyCharm Community, and click Install.

Well, now PyCharm installed on your machine. If you do not want to use the Toolbox app, you can install PyCharm alone.

Start PyCharm, you will see the Import Settings pop. PyCharm will automatically detect that this is the first installation, and select "Do not import settings" option for you. Click OK, then PyCharm will let you choose the keyboard map (keymap scheme). Leave the default settings, click the bottom right corner of the "Next: UI Themes":

PyCharm will be asked to select mode Darcula dark or light mode. You can choose your favorite mode and click "Next: Launcher Script":

This tutorial uses a dark mode Darcula.

On the next page, directly leave the default settings and click "Next: Featured plugins", then PyCharm will show a list of available plug-ins. Click "Start using PyCharm" Now you can write code!

Write code in PyCharm

In PyCharm, you can perform any operation in the "project" in. So, first you need to create a project.

Once installed and opened PyCharm, you will see the welcome page. Click on "Create New Project" appear "New Project" pop:

Specify the project location, open the Project Interpreter list, choose to create a new project or use an existing interpreter interpreter. Select "New environment using" open the drop-down list of its right, choose Virtualenv, Pipenv or Conda. These tools can create a different environment for the Python project alone, which were preserved dependencies required for different projects.

You can choose either one, this tutorial is Virtualenv. After selection, the designated location of the environment, the Python interpreter list, select base interpreter installed in the system. In general, keep the default settings. Here are two boxes: Inherit the global environment package in the new environment, so that the current environment can be used for all other projects, both not to vote.

Click the lower right corner of the "Create" to create a new project:

"Tip of the Day" appears on the screen pop, every time you start PyCharm provided by the pop trick. Turn off the pop.

Now we can start a new Python program. If you are using a Mac, use Cmd + N key; if you are using Windows or Linux systems, use Alt + Ins key. Then select Python File. You can also choose File → New from the menu. The new file is named guess_game.py and click OK. PyCharm you will see the following window:

As for the test code, we have to quickly write a simple guessing game, that is, the program allows users to select a number to guess, at each guess, the program will tell the user his guess is larger or smaller than the mysterious numbers, user numbers guess game over. The following is the code of the game:

Simply type the code above, instead of copying and pasting. You will see the following screen:

As shown in, FIG PyCharm Intelligent Coding Assistance provided above functions may be executed code completion, code checks, error highlighting and quick repair recommendations. For example, type the main tab and click the button, PyCharm will auto-complete the whole main clause.

In addition, if you forget to type a sentence if conditions before, in the last sentence and add .if click the Tab key, PyCharm will fix this if conditionals. The same applies to the use of True.while. That this is PyCharm of Postfix Completion feature that can help reduce the frequency of use backspace key.

In PyCharm run code

Now that you have completed the coding of the game, ready to run.

The game program operates in three ways:

Use the shortcut keys Ctrl + Shift + R on a Mac, Windows or Linux systems, use the shortcut Ctrl + Shift + F10.
Right-click the background and choose "Run" guess_game ' "from the menu.
Since the program has __main__ clause, you can click on the small green arrow __main__ clause on the left side, select "Run" guess_game '. "

Run the program using any of the above embodiment, bottom of the window panel terminal (Terminal pane), the output display your code:

You can play with this game, to see if he could guess the number. (Professional advice: from 50 starts guess.)

Debug code in the PyCharm

Find mysterious figures yet? If found, you may see some strange things: the program does not print out a congratulatory message and display the eject button, but reopened. This is where the bug. To find the reason to start the program again, you need to debug.

First, click on a blank area of the left side of the line 8 code, set breakpoints:

断点即程序运行到这一行时会自动停止，你可以探索断点处之后的代码有什么错误。接下来，从以下三种方式中选择一种开始 debug：

在 Mac 系统中使用 Ctrl+Shift+D 键，在 Windows 或 Linux 系统中使用 Shift+Alt+F9 键。
右键单击背景，选择「Debug 『guess_game』」。
点击__main__从句左侧的绿色小箭头，选择「Debug 『guess_game』」。

之后，你将看到底部出现 Debug 窗口：

按照下列步骤执行程序 debug：

注意当前行被蓝色高亮显示。
Debug 窗口显示 random_int 及其值。记录该数字。（上图中该数字为 85。）
点击 F8 执行当前代码行，并执行到下一行代码。如有必要，你也可以使用 F7 跳转到当前行内的函数。随着你继续执行语句，变量的变化将自动呈现在 Debugger 窗口。
注意 Debugger 标签右侧有一个 Console 标签。Console 标签和 Debugger 标签相互独立。你可以在 Console 中与程序进行交互，在 Debugger 中执行 debug 动作。
转向 Console 标签，进入猜测过程。
键入左侧 Debugger 标签中显示的数字，点击 Enter 键。
转回 Debugger 标签。
再次点击 F8，计算 if 语句。注意现在你在第 14 行。为什么不是第 11 行呢？因为第 10 行的 if 语句被计算为 False。那么为什么当你键入数字后它算出来为 False 了呢？
仔细看第 10 行，注意我们在对比 user_guess 和一个错误的项。我们应该对比用户猜测的数字和 random_int，但此处我们对比的是 randint（从 random 包导入的函数）。
将 randint 更改为 random_int，按照同样的步骤重新开始 debug。你会发现，这一次到达的是第 11 行，第 10 行算出来为 True：

恭喜你，bug 被修复了！

在 PyCharm 中进行代码测试

不经单元测试的应用都不可靠。PyCharm 可以帮助你快速舒适地写单元测试并运行。默认情况下，unittest 被用作测试运行器，而 PyCharm 还支持其他测试框架，如 pytest、nose、doctest、tox 和 trial。例如，你可以按照以下步骤为项目选择 pytest 测试运行器：

打开 Settings/Preferences → Tools → Python Integrated Tools 设置对话框。
在默认测试运行器字段中选择 pytest。
点击 OK 保存该设置。

本教程的示例将使用默认测试运行器 unittest。

在同一个项目中，创建文件 calculator.py，并将以下 Calculator 类放入该文件：

PyCharm 使得为已有代码创建测试变得轻而易举。打开 calculator.py 文件，执行以下步骤中的任意一个：

在 Mac 系统中使用 Shift+Cmd+T 键，在 Windows 或 Linux 系统中使用 Ctrl+Shift+T。
右键单击该类的背景，选择「Go To and Test」。
在主菜单中吗，选择 Navigate → Test。

选择「Create New Test…」，得到以下窗口：

Target directory、Test file name 和 Test class name 这三项均保留默认设置。选中上图中两种需要测试的方法并点击 OK。好了！PyCharm 自动创建文件 test_calculator.py，并在其中创建了以下 stub test：

使用以下方法中的任意一个运行测试：

在 Mac 系统中使用 Ctrl+R 键，在 Windows 或 Linux 系统中使用 Shift+F10 键。

右键单击背景，选择「Run 『Unittests for test_calculator.py』」。
点击测试类名称左侧的绿色小箭头，选择「Run 『Unittests for test_calculator.py』」。

你将看到底部出现测试窗口，所有测试均失败：

注意，左侧是测试结果的层次结构，右侧是终端的输出。现在，将代码更改成以下代码，实现 test_add：

重新运行测试，你会看到一个测试通过了，另一个则失败。按照如下操作探索不同选项，来展示已通过测试和被忽略测试，按照字母顺序对测试进行排序，以及按照时长对测试进行排序：

注意，上图中的 sleep(0.1) 方法的作用是使其中一个测试变慢，以便按时长对测试进行排序。

在 PyCharm 中编辑已有项目

单文件项目非常适合作为示例，但你通常需要处理较大的项目。这部分将介绍如何使用 PyCharm 处理较大项目。

为了探索 PyCharm 以项目为中心的特征，你将使用 Alcazar web 框架（该框架用于学习目的）。在本地复制该 repo（地址：https://realpython.com/optins/view/alcazar-web-framework/）。

当你在本地已有项目时，使用以下方法中的任意一个在 PyCharm 中打开项目：

在主菜单中点击 File → Open。

在欢迎页面点击 Open。

之后，在计算机中找到包含该项目的文件夹，并打开。

如果该项目包含虚拟环境，PyCharm 将自动使用该虚拟环境，并将它作为项目解释器。

如果你需要配置不同的虚拟环境 virtualenv，在 Mac 上打开 Preferences，或在 Windows 或 Linux 系统中使用 Ctrl+Alt+S 打开 Settings，找到 Project: ProjectName。打开下拉列表，选择 Project Interpreter：

从下拉列表中选择 virtualenv。如果没有要选择的项，则点击下拉列表右方的设置按钮选择 Add…。其余步骤和创建新项目的步骤相同。

在 PyCharm 中搜索和导航

在大项目中，我们很难记住每个事物的位置，因此快速导航和搜索非常重要。PyCharm 可以提供这些功能。接下来，我们使用上一节中打开的项目，实践以下快捷键：

在当前文件中搜索代码段：在 Mac 系统中使用 Cmd+F 键，在 Windows 或 Linux 系统中使用 Ctrl+F 键。
在整个项目中搜索代码段：在 Mac 系统中使用 Cmd+Shift+F 键，在 Windows 或 Linux 系统中使用 Ctrl+Shift+F 键。
搜索类：在 Mac 系统中使用 Cmd+O 键，在 Windows 或 Linux 系统中使用 Ctrl+N 键。
搜索文件：在 Mac 系统中使用 Cmd+Shift+O 键，在 Windows 或 Linux 系统中使用 Ctrl+Shift+N 键。
如果你不知道要搜索的是文件、类还是代码段，则搜索全部：按两次 Shift 键。

导航可使用以下快捷键：

前往变量的声明：在 Mac 系统中使用 Cmd 键，在 Windows 或 Linux 系统中使用 Ctrl 键，然后单击变量。
寻找类、方法或文件的用法：使用 Alt+F7 键。
查看近期更改：使用 Shift+Alt+C 键，或者在主菜单中点击 View → Recent Changes。
查看近期文件：在 Mac 系统中使用 Cmd+E 键，在 Windows 或 Linux 系统中使用 Ctrl+E 键，或者在主菜单中点击 View → Recent Files。
多次跳转后在导航历史中前进和后退：在 Mac 系统中使用 Cmd+[ / Cmd+] 键，在 Windows 或 Linux 系统中使用 Ctrl+Alt+Left / Ctrl+Alt+Right 键。

更多细节，参见官方文档：https://www.jetbrains.com/help/pycharm/tutorial-exploring-navigation-and-search.html。

PyCharm 中的版本控制

版本控制系统（如 Git 和 Mercurial）是现代软件开发世界中最重要的工具之一。因此，IDE 必须支持版本控制。PyCharm 在这方面做得很好，它集成了大量流行的版本控制系统，如 Git（和 Github (https://github.com/)）、Mercurial、Perforce 和 Subversion。

注：以下示例中使用的版本控制系统为 Git。

配置版本控制系统（VCS）

要想实现 VCS 集成，你需要在顶部菜单点击 VCS → VCS Operations Popup…，或者在 Mac 系统中使用 Ctrl+V 键，在 Windows 或 Linux 系统中使用 Alt+` 键。选择 Enable Version Control Integration…，你将看到以下窗口：

从下拉列表中选择 Git，点击 OK，这样你就为项目设置好了 VCS。（注意，如果你打开的已有项目已经具备版本控制系统，PyCharm 将会发现并自动使用该版本控制系统。）

这时如果你前往 VCS Operations Popup…，你会发现一个不同的弹窗，它具备选项 git add、git stash、git branch、git commit、git push 等等：

如果你找不到所需要的选项，你可以在顶部菜单中点击 VCS，选择 Git，在这里你可以创建和查看 pull request。

提交和冲突处理

这是 PyCharm 中 VCS 集成的两大特征，我个人经常使用并且非常喜欢。假如你完成了工作，打算提交，前往 VCS → VCS Operations Popup… → Commit…，或者在 Mac 系统中使用 Cmd+K 键，在 Windows 或 Linux 系统中使用 Ctrl+K 键。你将看到如下窗口：

在该窗口中，你可以：

选择要提交的文件
写下提交信息
在提交前执行各项检查
查看更改
点击右下角 Commit 按钮旁边的箭头，选择 Commit and Push…，从而一次性完成提交和 push。

是不是感觉很神奇很迅速？特别是如果你以前经常通过命令行手动执行这些任务时。

团队合作中会出现合并冲突（merge conflict）。当一个人对你正在处理的文件提交更改时，你们二人更改了同一行导致更改重叠，这时 VCS 无法决定选择你的更改还是队友的更改。那么你可以使用以下箭头和符号来解决这个问题：

看起来很奇怪，我们很难分辨应该删除哪些更改、保留哪些更改。不要怕，PyCharm 来了！它可以用更好、更简洁的方法解决冲突。在顶部菜单中前往 VCS，选择 Git，然后选择 Resolve conflicts…。选择存在冲突的文件，点击 Merge，出现以下窗口：

在左侧列中，你可以查看自己做的更改。在右侧列中，可以查看队友做的更改。而中间列则显示结果。存在冲突的代码行被高亮显示，你可以在它们旁边看到 X 和 >>/<<。点击箭头表示接受更改，点击 X 则表示拒绝更改。解决所有冲突后，点击 Apply 按钮：

在上图中，对于第一个冲突行，作者选择拒绝自己的更改，接受队友的更改。而在第二个冲突行中，作者接受了自己的更改，拒绝了队友的更改。

使用 PyCharm 中的 VCS 集成还可以执行很多操作。详情参见 https://www.jetbrains.com/help/pycharm/version-control-integration.html。

在 PyCharm 中使用插件和外部工具

在 PyCharm 中你可以找到开发所需的几乎所有功能。如果没找到，那么很可能存在一个插件，向 PyCharm 提供你需要的功能。例如，它们可以：

添加多语言和多框架支持
使用快捷键提示（shortcut hint）、文件监视器（file watcher）等提升你的生产效率
利用代码练习，帮助你学习新的编程语言

例如，IdeaVim 插件向 PyCharm 添加 Vim 模拟。如果你喜欢 Vim，这个插件可以实现不错的结合。

Material Theme UI 插件可将 PyCharm 的外观改变为 Material Design 的外观：

Vue.js 插件使 PyCharm 支持 Vue.js 项目。Markdown 插件使得在 IDE 内可以编辑 Markdown 文件，并实时预览渲染后的 HTML。

在 Mac 系统上点击 Preferences → Plugins，在 Windows 或 Linux 系统中点击 Settings → Plugins，你可以在 Marketplace 标签下找到和安装所有可用插件：

如果仍然没找到所需插件，你甚至可以自己开发一个。

如果你找不到合适的插件，又不想自己开发，因为 PyPI 上有可用的包，你可以将这个包作为外部工具添加到 PyCharm。以代码分析器 Flake8 为例。

首先，在所选 Terminal app 中键入 pip install flake8，从而在虚拟环境中安装 Flake8。或者也可以使用 PyCharm 集成的 Termina

在 Mac 系统上点击 Preferences → Tools，在 Windows 或 Linux 系统中点击 Settings → Tools，选择 External Tools。然后点击底部 (1) 处的 + 按钮。在弹出的窗口中，输入细节并在两个窗口中点击 OK，如下图所示：

上图中，Program (2) 指 Flake8，你可以在虚拟环境文件夹（bin）中找到它。Arguments (3) 表示你想用 Flake8 分析的文件。Working directory 表示项目目录。

你可以把这里所有项的绝对路径写死，但这就意味着你无法在其他项目中使用该外部工具，只能在一个项目中针对一个文件使用该工具。

因此你需要使用 Macros。它是$name$格式的变量，根据语境而变化。例如，当你编辑 first.py 时，$FileName$ 为 first.py，当你编辑 second.py 时，$FileName$ 为 second.py。你可以查看它们的列表，点击 Insert Macro… 按钮将其中一个插入。此处你使用了 macros，它们的值会根据你目前处理的项目而改变，Flake8 将继续准确执行其工作。

要想使用它，你需要创建文件 example.py，并在其中写入以下代码：

上述代码故意破坏了 Flake8 的一些规则。右键单击文件背景，选择 External Tools → Flake8。Flake8 分析结果将出现在窗口底部：

为了使效果更好，你可以为其添加快捷键。在 Mac 系统中选择 Preferences，在 Windows 或 Linux 系统中选择 Settings。然后，点击 Keymap → External Tools → External Tools。双击 Flake8，选择 Add Keyboard Shortcut，出现以下窗口：

上图中，快捷键是 Ctrl+Alt+A（本教程使用该快捷键）。你可以在文本框中添加喜欢的快捷键，然后在两个窗口中点击 OK。然后，你就可以用该快捷键，在 Flake8 的帮助下分析目前在处理的文件了。

PyCharm Professional 功能

PyCharm Professional 是 PyCharm 的付费版本，具备更多开箱即用的功能和集成。这部分将概览其主要功能，以及官方文档链接（其中详细介绍了每一项功能）。记住，以下功能在 PyCharm Community 版本中均不可用。

Django 支持

Django 是最流行和最受喜爱的 Python web 框架，PyCharm 对 Django 提供广泛的支持。要确保对 Django 的支持，需要执行以下步骤：

在 Mac 系统中打开 Preferences，在 Windows 或 Linux 系统中打开 Settings。
选择 Languages and Frameworks。
选择 Django。
检查复选框 Enable Django support。
应用更改。

现在确保了对 Django 的支持，你在 PyCharm 中的 Django 开发之旅将轻松很多。具体而言在创建项目时，你会得到一个专用的 Django 项目类型。这表示，当你选择该类型时，你将拥有所有必要文件和设置。这等同于使用 django-admin startproject mysite。

你也可以在 PyCharm 内直接运行 manage.py 命令。目前支持的 Django 模板，包括以下一些：

语法和错误高亮显示
代码补全
导航
block 名称补全
自定义标签和过滤器补全
标签和过滤器的快速文档
模板 debug 能力

除此之外，我们还可以在其他 Django 部分（如视图、URL 和模型）中执行代码补全、对 Django ORM 提供代码追踪支持（code insight support）、对 Django 模型提供模型依赖项关系图。

更多细节，参见官方文档：https://www.jetbrains.com/help/pycharm/django-support7.html。

数据库支持

现代数据库开发是一个复杂的任务，需要多个支持系统和工作流。这也是 JetBrains 开发独立 IDE DataGrip 的原因。DataGrip 是独立于 PyCharm 的产品，二者的应用场景和授权都不相同。

但幸运的是，通过 Database tools and SQL 插件（该插件默认开启），PyCharm 可以支持 DataGrip 中的所有特性。在该插件的帮助下，你可以查询、创建和管理数据库，不管数据库在本地、服务器，还是在云端。该插件支持 MySQL、PostgreSQL、Microsoft SQL Server、SQLite、MariaDB、Oracle、Apache Cassandra 等。
关于该插件的更多用途，请查看文档：https://www.jetbrains.com/help/pycharm/relational-databases.html。

线程并发可视化（Thread Concurrency Visualization）

Django Channels、asyncio 和近期框架（如 Starlette (https://www.starlette.io/)）表明异步 Python 编程正逐渐成为趋势。异步编程具备很多好处，但很难写，也很难 debug。在此类案例中，Thread Concurrency Visualization 就是医生，帮助你全面管理多线程应用并进行优化。

更多细节，参见文档：https://www.jetbrains.com/help/pycharm/thread-concurrency-visualization.html。

Profiler

说到优化，profiling 是另一种代码优化方法。profiling 可以帮助你查看代码的哪一部分占用了最多的执行时间。profiler 运行的优先级如下：

1. vmprof2. yappi3. cProfile

如果你没有安装 vmprof 或 yappi，则运行标准 cProfile。更多细节，参见：https://www.jetbrains.com/help/pycharm/profiler.html。

科学模式

Python 不仅是通用和 web 编程语言，由于 NumPy、SciPy、scikit-learn、Matplotlib、Jupyter 等库和工具的加持，Python 成为数据科学和机器学习领域的最优工具。有了这些强大工具，你还需要一个强大的 IDE 来支持这些库所具备的绘图、分析等所有功能。
关于科学模式的更多详情，参见 https://www.jetbrains.com/help/pycharm/matplotlib-support.html。
远程开发

很多应用出现 bug 的一个常见原因是，开发环境和生产环境不同。尽管在大多数情况下，开发时完美复制生产环境并不现实，但力求实现完美复刻是值得追寻的目标。

在 PyCharm 的帮助下，你可以使用另一台计算机（如 Linux VM）上的解释器对应用进行 debug。这样，你就可以拥有与生产环境一样的解释器了，从而避免很多因开发环境和生产环境差异导致的 bug。
详情参见：https://www.jetbrains.com/help/pycharm/remote-debugging-with-product.html。

结论

PyCharm 是最好的 Python 开发 IDE 之一。它提供大量优势，帮助执行例行任务，从而节约大量时间。学完本教程，现在你知道如何利用 PyCharm 提高生产效率了吗？

Python IDE strongest detailed Guide!

Guess you like