如何写出清晰又优雅的Python代码？我们给你这26条建议

女爷i 2023-01-17 14:56 67阅读 0赞

**导读：**Python Enhancement Proposal \#8叫作PEP 8，它是一份针对Python代码格式而编订的风格指南。尽管只要语法正确，代码随便怎么写都行，但采用一致的风格可以使代码更易读、更易懂。如果你的代码风格和其他Python程序员的相同，那么就能够更加顺利地与大家一起做项目。

即便你的代码只给自己看，也应该按照这套风格来写，以便以后修改更加容易一些，而且能够避开很多常见的错误。

作者：布雷特·斯拉特金（Brett Slatkin）

来源：大数据DT（ID：hzdashuju）

![146a594f8df5a815cfd9b96607044d10.png][]

PEP 8非常详细地描述了如何编写清晰的Python代码，而且会随着Python语言的发展持续更新。大家应该把完整指南阅读一遍：

https://www.python.org/dev/peps/pep-0008

笔者认为，下面这几条规则是绝对应该遵循的。

**01 与空白有关的建议**

（9条 / 26条）

在Python中，空白（whitespace）在语法上相当重要。Python程序员对空白字符的用法尤其在意，因为它们会影响代码的清晰程度。在这方面，大家应该遵循以下几条建议。

1.  用空格（space）表示缩进，而不要用制表符（tab）。
2.  和语法相关的每一层缩进都用4个空格表示。
3.  每行不超过79个字符。
4.  对于占据多行的长表达式来说，除了首行之外的其余各行都应该在通常的缩进级别之上再加4个空格。
5.  在同一份文件中，函数与类之间用两个空行隔开。
6.  在同一个类中，方法与方法之间用一个空行隔开。
7.  使用字典时，键与冒号之间不加空格，写在同一行的冒号和值之间应该加一个空格。
8.  给变量赋值时，赋值符号的左边和右边各加一个空格，并且只加一个空格就好。
9.  给变量的类型做注解（annotation）时，不要把变量名和冒号隔开，但在类型信息前应该有一个空格。

![4bfdc872b694e50dd3e61753fa8c15a5.png][]

**02 与命名有关的建议**

（7条 / 26条）

PEP 8建议采用不同的方式来给Python代码中的各个部分命名，这样在阅读代码时，就可以根据这些名称看出它们在Python语言中的角色。遵循以下与命名相关的建议。

1.  函数、变量及属性用小写字母来拼写，各单词之间用下划线相连，例如：lowercase\_underscore。
2.  受保护的实例属性，用一个下划线开头，例如：\_leading\_underscore。
3.  私有的实例属性，用两个下划线开头，例如：\_\_double\_leading\_underscore。
4.  类（包括异常）命名时，每个单词的首字母均大写，例如：CapitalizedWord。
5.  模块级别的常量，所有字母都大写，各单词之间用下划线相连，例如：ALL\_CAPS。
6.  类中的实例方法，应该把第一个参数命名为self，用来表示该对象本身。
7.  类方法的第一个参数，应该命名为cls，用来表示这个类本身。

**03 与表达式和语句有关的建议**

（6条 / 26条）

The Zen of Python中提到：“每件事都应该有简单的做法，而且最好只有一种。”PEP 8就试着运用这个理念，来规范表达式和语句的写法。

1.  采用行内否定，即把否定词直接写在要否定的内容前面，而不要放在整个表达式的前面，例如应该写if a is not b，而不是if not a is b。
2.  不要通过长度判断容器或序列是不是空的，例如不要通过if len(somelist) == 0判断somelist是否为\[\]或''等空值，而是应该采用if not somelist这样的写法来判断，因为Python会把空值自动评估为False。
3.  如果要判断容器或序列里面有没有内容（比如要判断somelist是否为\[1\]或'hi'这样非空的值），也不应该通过长度来判断，而是应该采用if somelist语句，因为Python会把非空的值自动判定为True。
4.  不要把if语句、for循环、while循环及except复合语句挤在一行。应该把这些语句分成多行来写，这样更加清晰。
5.  如果表达式一行写不下，可以用括号将其括起来，而且要适当地添加换行与缩进以便于阅读。
6.  多行的表达式，应该用括号括起来，而不要用\\符号续行。

![427ec78d300053bc95c91e17dd8f587f.png][]

**04 与引入有关的建议**

（4条 / 26条）

PEP 8对于怎样在代码中引入并使用模块，给出了下面几条建议。

1.  import语句（含from x import y）总是应该放在文件开头。
2.  引入模块时，总是应该使用绝对名称，而不应该根据当前模块路径来使用相对名称。例如，要引入bar包中的foo模块，应该完整地写出from bar import foo，即便当前路径为bar包里，也不应该简写为import foo。
3.  如果一定要用相对名称来编写import语句，那就应该明确地写成：from . import foo。
4.  文件中的import语句应该按顺序划分成三个部分：首先引入标准库里的模块，然后引入第三方模块，最后引入自己的模块。属于同一个部分的import语句按字母顺序排列。

*  提示：Pylint是一款流行的Python源码静态分析工具。它可以自动检查受测代码是否符合PEP 8风格指南，而且还能找出Python程序里的许多种常见错误。很多IDE（集合成开发环境）与编辑器，都包含这样的linting工具或者支持类似的插件。
    
    https://www.pylint.org/

**要点**

*  编写Python代码时，总是应该遵循PEP 8风格指南。
 *  与广大Python开发者采用同一套代码风格，可以使项目更利于多人协作。
 *  采用一致的风格编写代码，代码的后续修改更容易。

关于作者：布雷特·斯拉特金（Brett Slatkin），Google首席软件工程师，他是Google Surveys的联合技术创始人，也是PubSubHubbub协议的共同创造者之一。此外，Slatkin还发布了Google的第一个云计算产品——App Engine。早在15年前，Slatkin就开始在工作中使用Python管理Google大量的服务器群。他拥有纽约哥伦比亚大学计算机工程专业学士学位。

本文摘编自《Effective Python：编写高质量Python代码的90个有效方法》（原书第2版），经出版方授权发布。

![e312ee8a1f112e457124663c22b38ebd.png][]

延伸阅读《Effective Python》（原书第2版）

点击上图了解及购买

转载请联系微信：DoctorData

**推荐语：**Python编程进阶必读，基于Python3.8，新增31条建议！掌握Pythonic编程方式，写出高质量代码|进阶到编程高手的程序员修炼之道和代码整洁之道。

![音符][1d5d6e67e43d6c0ff83eb3e42a35a024.gif]

**划重点????**

**干货直达????**

*  [终于有人把A/B测试讲明白了][A_B]  
    
 *  [多图详解数据中台建设框架（建议收藏）][Link 1]  
    
 *  [中国人工智能最高奖，颁给了这些人][Link 2]
 *  [什么是架构？网络架构中都有什么？终于有人讲明白了][Link 3]

**更多精彩****????**

在公众号对话框输入以下**关键词**

查看更多优质内容！

**PPT** | **读书** | **书单** | **硬核** | **干货**** **| **讲明白 **|** 神操作**

**大数据** | **云计算** | **数据库** | **Python** | **爬虫** | **可视化**

**AI** | **人工智能** | **机器学习** | **深度学习** | **NLP**

**5G**** **|** 中台 **|** 用户画像**** **| **1024** | **数学 **|** 算法 **| **数字孪生**

据统计，99%的大咖都关注了这个公众号

**????**

[146a594f8df5a815cfd9b96607044d10.png]: /images/20221021/97f217d66843402cb89a98f95d2f98db.png
[4bfdc872b694e50dd3e61753fa8c15a5.png]: /images/20221021/1705b9c5104b4166a2423b0ee46d0c04.png
[427ec78d300053bc95c91e17dd8f587f.png]: /images/20221021/1403377da4c2456ab1d171c708429821.png
[e312ee8a1f112e457124663c22b38ebd.png]: /images/20221021/76a3744663934605858e7118e5bd846d.png
[1d5d6e67e43d6c0ff83eb3e42a35a024.gif]: /images/20221021/09256d4fab3f42cb8619ed5da7d537f2.png
[A_B]: http://mp.weixin.qq.com/s?__biz=MzI5OTk5OTM2Mw%3D%3D&chksm=ec8c39f8dbfbb0ee32a88b463e3ef4e5bdaba0b490f47460ed05b9855c59189f0f492b29bccb&idx=2&mid=2247528468&scene=21&sn=464512d39b0f6c50297c5f52537147fe#wechat_redirect
[Link 1]: http://mp.weixin.qq.com/s?__biz=MzI5OTk5OTM2Mw%3D%3D&chksm=ec8c2685dbfbaf93cfbae2728c9df7d61a2b19f001c3845e5fc0e87ff75dc80b5261d23eda64&idx=2&mid=2247528297&scene=21&sn=2401efe605e8e8092da5c4bc0043d716#wechat_redirect
[Link 2]: http://mp.weixin.qq.com/s?__biz=MzI5OTk5OTM2Mw%3D%3D&chksm=ec8c278fdbfbae992fb69d93570548471d0b9ae7c225c32873dc2f7bfa80b3d63cf3385ed471&idx=2&mid=2247528035&scene=21&sn=6112ff9eb12ae20b80146a8872363e9a#wechat_redirect
[Link 3]: http://mp.weixin.qq.com/s?__biz=MzI5OTk5OTM2Mw%3D%3D&chksm=ec8c24a6dbfbadb0ad72e50fe3484c4285b2a89a65237776f1ba3b43f58a16193091cdaeab0e&idx=2&mid=2247527754&scene=21&sn=1b384991cd65aa84761bff81b4ebd845#wechat_redirect