zoukankan      html  css  js  c++  java
  • python代码格式风格 PEP 8

    前言

    Python Enhancement Proposal #8叫做PEP 8,它是针对 Python 代码格式而编订的风格指南。

    编写 Python 代码时,总是应该遵循 PEP 8 风格指南。

    与广大 Python 开发者采用同一套风格,可以使项目更利于多个协作。

    采用一致的风格编写代码,代码的后续修改更容易。

    完整指南阅读:https://www.python.org/dev/peps/pep-0008/

    与空白有关的建议

    空白(whitespace)在语法上会影响代码的清晰程度。

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

    与命名有关的建议

    采用不同方式给代码各个部分命名,可以根据这些名称看出它们在 Python 语言中的角色。

    • 函数、变量及属性用小写字母来拼写,各单词之间用下划线相连,例如:lowercase_underscore。
    • 受保护的实例属性,用一个下划线开头,例如:_leading_underscore。
    • 私有的实例书写,用两个下划线开头,例如:__double_leading_underscore。
    • 类(包括异常)命名时,每个单词的首字母均大写,例如:CapitalizedWord。
    • 模块级别的常量,所有字母都大写,各单词之间用下划线相连,例如:ALL_CAPS。
    • 类中的实例方法,应该把第一个参数命名为 self,用来表示该对象本身。
    • 类方法的第一个参数,应该命名为 cls,用来表示这个类本身。

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

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

    与引入有关的建议

    • import 语句(含 from x import y)总是应该放在文件开头。
    • 引入模块时,总是应该使用绝对名称,而不应该根据当前模块路径来使用相对名称。例如,要引入 bar 包中的 foo 模块,应该完整地写出 from bar import foo,即便当前路径为 bar 包里,也不应该简写为 import foo。
    • 如果一定要用相对名称来编写 import 语句,那就应该明确地写成:from . import foo
    • 文件中的 import 语句应该按顺序划分三个部分:首先引入标准库的模块,然后引入第三方模块,最后引入自己的模块。属于同一个部分的 import 语句按字母顺序排列。
  • 相关阅读:
    MyBatis学习总结(三)——优化MyBatis配置文件中的配置
    MyBatis学习总结(一)——MyBatis快速入门
    java基础学习总结——java环境变量配置
    java基础学习总结——开篇
    java基础学习总结——基础语法1
    java基础学习总结——基础语法2
    java基础学习总结——面向对象1
    java基础学习总结——异常处理
    Linux网络配置(setup)
    Linux搭建Apache+Tomcat实现负载均衡
  • 原文地址:https://www.cnblogs.com/niuben/p/15786363.html
Copyright © 2011-2022 走看看