Python编码规范(PEP 8)

2024年05月09日 Python编码规范 PEP 8 极客笔记

Python编码规范(PEP 8)

介绍

PEP 8 是 Python 代码风格规范,旨在提高代码的可读性和一致性。在编写 Python 代码时,遵循 PEP 8 可以使代码更易于阅读、维护和共享。本文将详细解释 PEP 8 中的各项规则,并给出示例代码说明。

缩进

使用四个空格作为缩进,不使用制表符。在一行代码超过规定长度时,可以使用续行符 \ 进行换行,按照缩进级别进行对齐。

示例代码:

# 正确的缩进示例
def test_function():
    for i in range(5):
        if i % 2 == 0:
            print(i)
        else:
            print("Odd number")

# 超出规定长度时使用续行符
my_list = [
    "apple", "banana", "cherry", "date", \
    "elderberry"
]

行长

每行代码的最大长度为 79 个字符,注释的最大长度为 72 个字符。如果表达式很长,可以使用括号对其进行换行。

示例代码:

# 正确的行长示例
my_long_expression = (some_long_variable +
                      another_long_variable -
                      third_long_variable)

# 超出规定行长示例
this_is_a_long_variable_name = some_function(some_long_argument) + \
                               another_function(another_long_argument)

空格

  • 在逗号、分号、冒号和其他句末符号后需使用空格;
  • 在冒号、分号和逗号前不需要使用空格;
  • 在二元运算符的两侧使用空格;
  • 不要在括号、括号内的元素和索引之间使用空格;
  • 函数的参数列表、索引和切片需要使用空格;
  • 复合语句中,关键词与括号之间需要使用空格。

示例代码:

# 错误的空格示例
my_list = [1, 2 , 3]
result = 5*2

# 正确的空格示例
my_list = [1, 2, 3]
result = 5 * 2
my_function(a, b)
my_string[1:3]
if x == 5:
    print("This is a correct example")

注释

  • 注释应该是单独一行,或在代码后空两格后注释;
  • 注释应该尽量避免在代码中出现拼写错误和语法错误。

示例代码:

# 错误的注释示例
variable = 10 # This variable stores the vaue of 10

# 正确的注释示例
# This variable stores the value of 10
variable = 10

命名规范

  • 模块名应该短小,全小写,可以使用下划线进行分词;
  • 类名使用驼峰命名法,首字母大写;
  • 函数和方法名全小写,可以使用下划线进行分词;
  • 常量全大写,可以使用下划线进行分词。

示例代码:

# 正确的命名示例
import math_functions
class MyClass:
    def my_method(self):
        return "Hello World"

MY_CONSTANT = 100

引号

可以使用单引号或双引号表示字符串,但应在整个文件中保持一致。三重引号可以用于包含换行的长字符串。

示例代码:

# 正确的引号示例
my_string = "This is a string"
another_string = 'This is another string'
multiline_string = '''This is a
multiline string'''

导入规范

  • 每个导入应该在单独的行;
  • 标准库导入在文件的顶部;
  • 第三方库导入在标准库导入之后,空行分隔;
  • 本地库导入在第三方库导入之后,空行分隔。

示例代码:

# 正确的导入示例
import os
import sys

import requests

import my_module

其他规范

  • 避免使用通用的名称,如 lOI,以免与数字 1 和 0 混淆;
  • 不要在行尾添加空格;
  • 模块级别的函数和类应在函数和类之间空两行。

结语

遵循 PEP 8 的编码规范可以使代码更具可读性、可维护性和可移植性。编程时应该时刻注意规范,提高代码质量。

本文链接:http://so.lmcjl.com/news/4131/

展开阅读全文