如何用一行命令格式化 Python 代码?

大家好，我是涛哥。

复制别人的代码进行使用的时候，最烦的就是看到编辑器上显示的各种红色的、橙色的提示线吧？

尤其是那些不遵守PEP8规则的代码，等号两边的空格会加到你手软。

真希望哪天全世界写Python的小伙伴们都能统一代码规范啊！然而这显然是不可能的。

不过虽然无法改变他人，但我们可以改变自己。现在有了Black这个神器，我们可以在终端中输入一句命令自动使用最规范的代码风格来格式化代码！

对于初学者来说，用Black来学习代码规范也是一个非常不错的选择。

01.准备

请选择以下任一种方式输入命令安装依赖：

1. Windows 环境 打开 Cmd (开始-运行-CMD)。
2. MacOS 环境 打开 Terminal (command+空格输入Terminal)。
3. 如果你用的是 VSCode编辑器 或 Pycharm，可以直接使用界面下方的Terminal.

pip install black

02.使用

安装完成之后，你有两种使用black的方式，一种是直接在命令里输入：

black 你的文件路径.py

它就会自动格式化该Python文件，如果你使用VSCode，我推荐使用这种方法来格式化。

比如说下面这个糟糕的格式：

真的各种线条都出现了，安装完Black后你只需要在终端中输入：

black test.py

就能一键美化到符合PEP8标准的代码格式：

第二种是在Pycharm中一键使用。

在PyCharm菜单 File->Setting->Tools->External Tools->单击按钮“+”号：

为了能够一键执行命令，在弹出窗口里的Name中输入一个名字作为在以后在Pycharm 菜单->Tools->External Tools 中显示的名字。

这个名字将作为我们一键格式化代码的入口，我在此输入名字为BlackFormatter：

在Programs中输入black安装后的black.exe文件所在目录。该目录在Windows的cmd窗口中通过命令where black查找到，在Linux中用命令which black查找。

例如我的路径是：
C:\Users\Ckend\Anaconda3\Scripts\black.exe
将此包含balck.exe文件名的全路径填入到Programs框中。

最后在Arguments中填入$FilePath$，在Working Directory中填入$ProjectFileDir$。然后单击OK即可。

这样，只需要点击你刚配置时输入的名称：

Tools->External Tools -> BlackFormatter

即可直接格式化当前文件。

Pycharm下方如图所示则说明格式化成功：

Pycharm也可以使用命令的方式格式化，在Terminal里输入即可，因为它其实和Vscode的终端是一个东西，注意black安装的环境和你终端使用的虚拟环境是一致的就行。

好了，今天的学习就到这里，如果大家希望深度学习的话，可以加入我的社群，与900多位同学一起学习；我是涛哥，我决定干一件大事：做最专业的Python社群！

往期文章别再问我如何双击打开.ipynb文件了！揭露：我是如何保持每天7小时高效工作的？Python最会变魔术的魔术方法，我觉得是它！