编写高质量 Python 代码的 47 个建议

我在这里总结归纳了 47 个有关 Python 代码的建议，试图去帮助你编写高质量的 Pyhon 代码。希望你能从中得到一定的收获。

---

建议1：放弃自己的代码风格

也许规范的书写看上去千篇一律，没有自己风格的代码没有特色。但是这样做可以帮助你规范你的代码，让它更加漂亮易读,而且统一的规范对于一个团队非常重要。

建议2：代码中添加适当的注释

更新代码的同时别忘记更新注释。

建议3：适当的添加空行

布局清晰、整洁、优雅的代码能够给阅读它的人带来愉悦感，而且它能帮助开发者之间进行良好的沟通。

建议4：编写函数的4个建议

• 原则1 函数设计要尽量短小，嵌套层次不宜过深。

• 原则2 函数申明应该做到合理、简单、易于使用。

• 原则3　函数参数设计应该考虑向下兼容。

• 原则4 一个函数只做一件事，尽量保证函数语句粒度的一致性。

建议5：常量集中在一起

将自己定义的常量使用全大写的命名，并将它们定义在一个文件中，这样更加方便使用和有利于维护。

建议6：利用 assert 语句发现问题

断言（assert）在很多语言中都存在，它主要为调试程序服务，能够快速方便地检查程序的异常或者发现不恰当的输入等，可防止意想不到的情况出现。

建议7：直接交换数据

当我们需要交换两个变量的值时，不推荐使用中间变量，这样更简洁且效率更高。

x, y = y, x

建议8：不推荐使用 tpye 来检查类型

基于内建类型扩展的用户自定义类型，type 函数并不能准确返回结果。因此更加推荐使用 isintance。

建议9：除法时尽量转为浮点类型

标准的算术运算，包括除法，返回值总是和操作数类型相同。当你编写一个函数时，即使你希望调用者传入的是浮点类型，但如果不在函数入口进行类型检查或者转换，就无法阻止函数调用者传递整数参数，而往往这种类型的错误还不容易发觉。因此推荐的做法之一是当涉及除法运算的时候尽量先将操作数转换为浮点类型再做运算。

建议10：尽量少的使用 eval

Python中eval()函数将字符串str当成有效的表达式来求值并返回计算结果。实际应用过程中如果使用对象不是信任源，应该尽量避免使用eval，在需要使用eval的地方可用安全性更好的ast.literal_eval替代。

建议11：使用enumerate()获取序列迭代的索引和值

它代码清晰简洁，可读性好。它具有一定的惰性（lazy），每次仅在需要的时候才会产生一个(index, item)对。

enumerate() 函数的内部实现非常简单，enumerate(sequence,start=0) 实际相当于如下代码：

def enumerate(sequence, start=0):
    n = start
    for elem in sequence:
        yield n, elem
        n += 1

因此利用这个特性用户还可以实现自己的 enumerate() 函数。比如，myenumerate() 以反序的方式获取序列的索引和值:

def myenumerate(sequence):
    n = -1
    for elem in reversed(sequence):
        yield len(sequence) + n, elem
        n -= 1

建议12：区分 == 与 is

is 的作用是用来检查对象的标示符是否一致的，也就是比较两个对象在内存中是否拥有同一块内存空间，它并不适合用来判断两个字符串是否相等。而 == 才是用来检验两个对象的值是否相等的，它实际调用内部__eq__() 方法。所以 == 操作符是可以被重载的，而 is 不能被重载。

建议13：考虑兼容性，尽量使用 Unicode

建议14：少的使用 form ... import

• 一般情况下尽量优先使用 import a 形式，如访问 B 时需要使用 a.B 的形式。

• 有节制地使用 from a import B 形式，可以直接访问 B。

• 尽量避免使用 from a import *，因为这会污染命名空间，并且无法清晰地表示导入了哪些对象。

更详细的说明：https://blog.csdn.net/qq_38410494/article/details/106679049

建议15：i += 1 不等于 ++i

我们都知道 Python 中不支持自加和自减操作，但是 ++i，--i 这样的操作并不是错误的，这里的 + 和 - 代表的只是正负符号。因此你需要明白 ++i 在Python中语法上是合法的，但并不是我们理解的通常意义上的自增操作。

建议16：使用 with 自动关闭资源

建议17：多使用 else 子句简化循环

看一下代码：

def print_prime(n):
    for i in range(2, n):
        found = True
        for j in range(2, i)
            if i % j == 0:
                found = False
                break
        if found:
            print("{i} is a prime number".format(i))

这是一个查找素数的简单实现，可以看到我们借助了一个标志量 found 来判断是循环结束是不是由 break 语句引起的。如果对 else 善加利用，代码可以简洁得多。来看下面的具体实现：

def print_prime(n):
    for i in range(2, n):
        for j in range(2, i)
            if i % j == 0:
                found = False
                break
        else:
            print("{i} is a prime number".format(i))

当循环“自然”终结（循环条件为假）时 else 从句会被执行一次，而当循环是由 break 语句中断时，else 子句就不被执行。与 for 语句相似，while 语句中的 else 子句的语意是一样的：else 块在循环正常结束和循环条件不成立时被执行。

建议18：异常处理的基本原则

• 注意异常的粒度，不推荐在try中放入过多的代码。

• 谨慎使用单独的except语句处理所有异常，最好能定位具体的异常。

• 注意异常捕获的顺序，在合适的层次处理异常。

• 使用更为友好的异常信息，遵守异常参数的规范。

• 如果内建异常类不能满足需求，用户可以在继承内建异常的基础上针对特定的业务逻辑定义自己的异常类。

建议19：拼接字符串推荐 join

字符串处理在大多时候会常常遇到，在 Python 中我们可以使用 join 和 + 两种常见的方式来拼接字符串，代码如下：

str1, str2, str3 = "abc", "de", "fg"

str4 = str1 + str2 + str3
str5 = ''.join([str1, str2, str3])

如果进行过测试，就会发现，join 的速度是要高于 + 操作的，特别当拼接的字符串越多的时候。那么为什么呢？

这就关系到两个操作在内存中具体是怎么实现的。假设现在有 s1, s2, s3, ..., sn 个字符串，我们现在要拼接它们。如果使用 + 操作时，每遇到一次 + 号就会申请内存并将字符串复制到新的内存中，那么我们要拼接 n 个字符串时，就需要申请 n-1 次内存，当 n 越大时，效率会越低。

而当用 join() 方法连接字符串的时候，会首先计算需要申请的总的内存空间，然后一次性申请所需内存并将字符序列中的每一个元素复制到内存中去。因此，字符串的连接，特别是大规模字符串的处理，应该尽量优先使用join而不是+。

建议20：格式化字符串使用 .format

Python中内置的 % 操作符和 .format 方式都可用于格式化字符串。

• 理由一：format方式在使用上较%操作符更为灵活。使用format方式时，参数的顺序与格式化的顺序不必完全相同。

• 理由二：format方式可以方便地作为参数传递。

• 理由三：%方法在某些特殊情况下使用时需要特别小心。

如果你使用的 Python 是 3.8 以上，还可使用f{} 字符串。具体可以看这里：https://blog.csdn.net/qq_38410494/article/details/106691210

建议21：记住函数传参既不是传值也不是传引用

正确的叫法应该是传对象（call by object）或者说传对象的引用（call-by-object-reference）。函数参数在传递的过程中将整个对象传入，对可变对象的修改在函数外部以及内部都可见，调用者和被调用者之间共享这个对象，而对于不可变对象，由于并不能真正被修改，因此，修改往往是通过生成一个新对象然后赋值来实现的。

建议22：尽量不使用变长参数

• 使用过于灵活。

• 如果一个函数的参数列表很长，虽然可以通过使用 *args 和 **kwargs 来简化函数的定义，但通常这意味着这个函数可以有更好的实现方式，应该被重构。

• 可变长参数适合在下列情况下使用（不仅限于以下场景）：为函数添加一个装饰器。

建议23：区分 str() 和 repr()

函数 str() 和 repr() 都可以将 Python 中的对象转换成字符串，但两者依旧存在区别：

• 两者之间的目标不同：str() 主要面向用户，其目的是可读性，返回形式为用户友好性和可读性都较强的字符串类型；而 repr() 面向的是 Python 解释器，其返回值表示 Python 解释器内部的含义，常作为编程人员debug用途。

• 在解释器中直接输入 a 时默认调用 repr() 函数，而 print a 则调用 str() 函数。

• repr() 的返回值一般可以用 eval() 函数来还原对象。

• 这两个方法分别调用内建的 __str__() 和 __repr__() 方法，一般来说在类中都应该定义 __repr__() 方法，而 __str__() 方法则为可选，当可读性比准确性更为重要的时候应该考虑定义 __str__() 方法。如果类中没有定义 __str__() 方法，则默认会使用 __repr__() 方法的结果来返回对象的字符串表示形式。用户实现 __repr__() 方法的时候最好保证其返回值可以用 eval() 方法使对象重新还原。

建议24：掌握字符串的用法

有人说过，编程有两件事，一件是处理数值，另一件是处理字符串。所以掌握字符串的用法尤为重要。具体可以看看这篇博客：https://blog.csdn.net/qq_38410494/article/details/106697509

建议25：了解并学会选择 sort() 和 sorted()

• 两者都是排序，但 sorted() 的使用范围更加广。

• sorted() 在 Python2.4 中引入，返回一个排序后的列表，原列表保持不变;sort() 直接修改原有列表，函数返回 None。

• sorted() 可以作用与任何可迭代对象，而 sort() 一般作用与列表。

建议26：使用Counter进行计数统计

>>> from collections import Counter
>>> datas = ['a', '2', 2, 4, 5, '2', 'b', 4, 7, 'a', 5, 'd', 'a', 'z']
>>> print(Counter(datas))
Counter({'a': 3, '2': 2, 4: 2, 5: 2, 2: 1, 'b': 1, 7: 1, 'd': 1, 'z': 1})

Counter类是自Python2.7起增加的，属于字典类的子类，是一个容器对象，主要用来统计散列对象，支持集合操作 +、-、&、|，其中 & 和 | 操作分别返回两个Counter对象各元素的最小值和最大值。

建议27：使用 pandas 处理大型 CSV 文件

Pandas即Python Data Analysis Library，是为了解决数据分析而创建的第三方工具，它不仅提供了丰富的数据模型，而且支持多种文件格式处理，包括CSV、HDF5、HTML等，能够提供高效的大型数据处理。其支持的两种数据结构—— Series 和 DataFrame ——是数据处理的基础。

建议28：使用 traceback 获取栈信息

当程序产生异常的时候，最需要面对异常的其实是开发人员，他们需要更多的异常提示的信息，以便调试程序中潜在的错误和问题。traceback模块可以满足这个需求，它会输出完整的栈信息。类似这样：

execpt IndexError as e:
    print("the index out of range")
    print(e)
    traceback.print_exc()

建议29：使用 logging 记录日志信息

仅仅将栈信息输出到控制台是远远不够的，更为常见的是使用日志保存程序运行过程中的相关信息，如运行时间、描述信息以及错误或者异常发生时候的特定上下文信息。

建议30：推荐使用 threading 编写多线程

建议31：使用 Queue 多线程更安全

建议32：知道 __init__() 不是构造方法

实际上 __init__() 并不是真正意义上的构造方法，__init__() 方法所做的工作是在类的对象创建好之后进行变量的初始化。__new__() 方法才会真正创建实例，是类的构造方法。

建议33：理解 self 参数

也许很多人感受self最奇怪的地方就是：在方法声明的时候需要定义self作为第一个参数，而调用方法的时候却不用传入这个参数。这里简单说说为什么需要 self：

• Python 在当初设计的时候借鉴了其他语言的一些特征。

• Python 语言本身的动态性决定了使用 self 能够带来一定便利。

• 在存在同名的局部变量以及实例变量的情况下使用self使得实例变量更容易被区分。

建议34：区分 __getattr__() 和 __getattribute__()

__getattr__() 和 __getattribute__() 都可以用做实例属性的获取和拦截，__getattr__() 适用于未定义的属性，即该属性在实例中以及对应的类的基类以及祖先类中都不存在，而 __getattribute__() 对于所有属性的访问都会调用该方法。需要注意的是 __getattribute__() 仅应用于新式类。

__getattribute__() 总会被调用，而 __getattr__() 只有在 __getattribute__() 中引发异常的情况下才会被调用。

建议35：掌握 metaclass

元类用来指导类的生成，元方法可以从元类或者类中调用，不能从类的实例中调用，而类方法既可以从类中调用也可以从类的实例中调用。

建议36：熟悉 Python 的迭代器

建议37：熟悉 Python 的生成器

建议38：理解 GIL 的局限性

GIL 被称为为全局解释器锁（Global Interpreter Lock），是 Python 虚拟机上用作互斥线程的一种机制，它的作用是保证任何情况下虚拟机中只会有一个线程被运行，而其他线程都处于等待GIL锁被释放的状态。

在单核 CPU 中，GIL 对多线程的执行并没有太大影响，因为单核上的多线程本质上就是顺序执行的。多核 CPU 已经成为一个常见的现象，GIL 的局限性限制了其在多核 CPU 上发挥优势，因此对于 GIL 的去留也曾引发过激烈的讨论。

Guido以及Python的开发人员都有一个很明确的解释，那就是去掉GIL并不容易。Python1.5 他们曾尝试过，但结果非常糟糕。Python3.2 他们重新实现了 GIL，进行了优化。至少目前看来，GIL 依旧会保留。

建议39：使用 multiprocessin 克服 GIL 缺陷

为了能够充分利用多核优势，Python 的专家们提供了另外一个解决方案：多进程。Multiprocessing 由此而生，它是Python中的多进程管理包，主要用来帮助处理进程的创建以及它们之间的通信和相互协调。

建议40：使用线程池提高效率

线程池，它通过将事先创建多个能够执行任务的线程放入池中，所需要执行的任务通常被安排在队列中。由于线程预先被创建并放入线程池中，同时处理完当前任务之后并不销毁而是被安排处理下一个任务，因此能够避免多次创建线程，从而节省线程创建和销毁的开销，带来更好的性能和系统稳定性。

建议41：使用 Pylint 检查代码风格

如果你的团队遵循PEP8的编码风格，Pylint是个不错的选择（当然还有其他很多选择，如pychecker、pep8等）。

建议42：了解代码优化的基本原则

1. 优先保证代码是可工作的。

2. 权衡优化的代价，优化是有代价的，想解决所有性能问题几乎是不可能的。、

3. 定义性能指标，集中力量解决首要问题，在进行优化之前，一定要针对问题进行主次排列，并集中力量解决主要问题。

4. 不要忽略可读性，优化不能以牺牲代码的可读性，甚至带来更多的副作用为代价。

建议43：让 cProfile 定位性能拖油瓶

程序性能影响往往符合 80/20 法则，即 20% 的代码的运行时间占用了 80% 的总运行时间，实际上，比例要夸张得多。所以如何定位瓶颈所在很有难度，靠经验是很难找出造成性能瓶颈的代码的。这时候，我们需要一个工具帮忙，profile 是Python的标准库。可以统计程序里每一个函数的运行时间，并且提供了多样化的报表，而 cProfile 则是它的C实现版本，剖析过程本身需要消耗的资源更少。所以在Python 3 中，cProfile 代替了 profile，成为默认的性能剖析模块

建议44：努力降低算法复杂度

同一问题可用不同算法解决，而一个算法的优劣将直接影响程序的效率和性能。算法的评价主要从时间复杂度和空间复杂度来考虑。

建议45：学会优化循环

1. 减少循环内部的计算。能提出循环的运算不要在循环内部进行。

2. 将显式循环改为隐式循环。比如，求 1, 2, ..., n 的和，可以写成 n*(n+1)/2。类似的情况写成计算表达式效率更高，这可能牺牲了可读性，这时注释就显得尤为重要。

3. 在循环中尽量引用局部变量。在命名空间中局部变量优先搜索，因此局部变量的查询会比全局变量要快。

4. 关注内层嵌套循环。在多层嵌套循环中，重点关注内层嵌套循环，尽量将内层循环的计算往上层移。

建议46：选择合适的数据结构

在解决性能问题的时候，往往可以从使用的数据结构入手。了解不同数据结构的实现原理，针对不同的应用场景选择合适的数据结构，也是优化性能的一种有效手段。

建议47：使用 C/C++ 模块扩展提高性能

Python 具有良好的可扩展性，利用 Python 提供的 API，如宏、类型、函数等，可以让 Python 方便地进行 C/C++ 扩展，从而获得较优的执行性能。

但是，这种方式仍然有几个问题让Pythonistas非常头疼。那就是掌握 C/C++ 的学习成本巨大，而且编写过程繁琐复杂。通过开发人员的艰苦工作，Cython 诞生了，它可以把Python代码直接编译成等价的C/C++代码，从而获得性能提升。所以在这里推荐使用 Cython 编写扩展模块。

---

到这里就是全部的 47 个有关编写高质量 Python 代码的建议，不知道你有没有收获。