PEP 8 摘要

 

 

1. 设置代码格式

　　随着你编写的程序愈来愈长，有必要了解一些代码格式设置约定。请花时间让你的代码竟可能易于阅读；让代码易于阅读有助于你掌握程序是怎么作的，也能够帮助他人理解你编写的代码。

　　为确保全部人编写的代码的结构都大体一致，Python程序员都遵循一些格式设置约定。学会编写整洁的Python后，就能够明白他人编写的Python代码的总体结构——这要他们和你遵循相同的指南。要成为装也程序员，应从如今开始就遵循这些指南，以养成良好的习惯。

 

2. 格式设置指南

　　如果要提出Python语言修改建议，须要编写Python改进提案（Python Enhancement Proposal ,PEP）。PEP 8是最古老的PEP之一，它向Python程序员提供了代码格式设置指南。PEP 8的篇幅很长，可是大部分与复杂的代码结构相关。

　　Python格式设置指南的编写者深知，代码被阅读的次数比编写的次数多。代码编写出来后，调试时你须要阅读它；给程序添加新功能是，须要花很长的时间阅读代码；与其余程序员分享代码时，这些程序员也将阅读它们。

　　若是必定要在让代码在易于编写和易于阅读之间作出选择，Python程序员几乎老是会选择后者。下面的指南能够帮助你从一开始就编写出清晰的代码。

 

3. 缩进

　　PEP 8建议每级缩进都是用四个空格，这既能够提升可读性，又留下了足够的多级缩进空间。

　　在字处理文档当中，你们经常使用制表符而不是空格来缩进。对于字处理文档来讲，这样作的效果很好，可是混合使用制表符和空格会让Python解释器感到迷惑。每款文本编辑器都提供了一种设置，能够将输入的制表符转换为指定数量的空格。你在编写代码时应该使用制表符键，可是必定要对编辑器进行设置，使其在文档之中插入空格而不是制表符。

　　在程序当中混合使用制表符和空格可能致使极难解决的问题。若是你混合使用了制表符和空格，能够将文件当中全部的制表符转换为空格，大多数编辑器都提供了这样子的功能。

4. 行长

　　不少Python程序员都建议每行不超过80字符。最初制定这样的指南时，在大多数计算机当中，终端窗口每行只能容纳79字符；当前，计算机屏幕每行能够容纳的字符数量多得多，为什么还要使用79字符的标准行长呢？这里有别的缘由。专业的程序员一般会在同一个屏幕上打开多个文件，使用标准行长可让他们在屏幕上并排打开两三个文件时可以同时看到各个文件的完整行。PEP 8还建议注释的行长不超过72字符，由于有一些工具为大型项目自动生成文档时，会在每一行注释开头添加格式化字符。

　　PEP 8当中有关行长的指南并不是是不可逾越的红线，有一些小组将最大行长设置为99字符。在学习期间，你不用过多地考虑代码的行长，可是也别忘了，协做编写程序时，你们几乎都遵照PEP 8指南。在大多数编辑器当中，均可以设置一个视觉标志——一般是一条竖线，让你知道不能越过的界线在什么地方。

 

5. 空行

　　要将程序的不一样部分分开，可使用空行。你应该使用空行来组织程序文件，可是也不能滥用；只要掌握其中的平衡。例如，若是你有5行建立列表的代码，还有3行处理该列表的代码，那么用一个空行将这两部分隔开是合适的。然而，你不该使用三四个空行将它们隔开。

　　空行虽然不会影响到代码的运行，可是会影响到代码的可读性。Python解释器根据水平缩进状况来解读代码，但不关心垂直间距。