PEP 8 是 Python 官方的代码风格规范,由 Python 社区维护。它为编写干净、可读且一致的 Python 代码提供了指南和约定。遵循 PEP 8 代码风格规范,有助于提高代码质量,并使开发人员更容易在项目上进行协作。
以下是 PEP 8 代码风格规范中的一些关键点,我们将通过 Python 代码示例来了解 PEP 8。
PEP 8 代码风格规范的关键点「缩进」
每个缩进级别使用 4 个空格,避免使用制表符。避免空格制表符混用。
「最大行长」
代码的每行最大长度限制为 79 个字符。对于字符串及注释,行长应限制为 72 字符。对于长行,请使用反斜杠或其他适当的方法断开。
# 反斜杠断行str1 = "longlonglonglonglonglonglonglonglonglonglonglonglonglonglong\longlonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglong"# 使用(),{},[]断行,需要在每行两边都加上引号# 使用{},[]断行,会改变原来数据的类型str1 = ("longlonglonglonglonglonglonglonglonglonglonglonglonglonglong""longlonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglong")# 使用三引号str1 = """longlonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglong"""「导入」
使用 import 导入库时,导入语句通常写成单独的行。
导入应按以下顺序进行:
标准库导入相关第三方导入特定模块导入# 错误方式import sys, os# 正确方式import osimport sys# 不过可以这样from math import floor, fabs「表达式和语句中的空格」
在以下情况下使用空格:
紧挨在逗号、分号或冒号后面。在运算符两端。避免在表达式和语句中使用多余的空格。
#错误方式x=1y=2x,y=y,x# 正确方式x = 1y = 2x, y = y, x「注释」
建议使用注释来说明代码,但要避免过度注释。
注释应该是完整的句子,如果长度很长,应该放在单独的一行上。
「函数和变量名称」
使用小写字母命名,使用下划线分隔函数或变量名称中的单词以提高可读性。
# 错误方式def Myfunction(x, y): return x + yMyresult = Myfunction(5, 10)print(Myresult)# 正确方式(小写字母命名,下划线分隔单词)def my_function(x, y): return x + ymy_result = my_function(5, 10)print(my_result)「常量」
常量应为大写,下划线分隔单词。+
PI = 3.1415926「空行」
使用空行分隔类和函数内的代码块。
「字符串引号」
短字符串使用单引号,长字符串使用双引号。
编码风格的一致性很重要,如果你的项目已经遵循某种风格,请坚持下去。以上这些只是 PEP 8 代码规范的亮点,更详细的代码风格规范,请参考官方 PEP 8 风格指南。
❝
文章创作不易,如果您喜欢这篇文章,请关注、点赞并分享给朋友。如有意见和建议,请在评论中反馈。
❞