美文网首页
Python—PEP8编码和命名习惯

Python—PEP8编码和命名习惯

作者: 杨海py | 来源:发表于2018-11-13 11:14 被阅读0次

    代码编排

    使用4空格缩进,不使用Tab,更不允许用Tab和空格混合缩进
    每行最大长度最大79字节,超过部分使用反斜杠折行
    类和全局函数定义间隔两个空行,类内方法定义间隔一个空行.其它地方可以不加空行。
    

    文档编排

    其中import部分,又按标准、三方和自己编写顺序依次排放,之间空一行。
    不要在一句import中导入多个模块,比如不推荐import os, sys。
    尽可能用import XX 而不采用from XX import YY引用库,因为可能出现名字冲突。
    

    空格的使用

    各种右括号前不用加空格
    逗号、冒号、分号前不要加空格。
    函数的左括号前不要加空格。如func(1)。
    序列的左括号前不要加空格。如list[2]。
    操作符左右各加一个空格,不要为了对齐增加空格。
    函数默认参数使用的赋值符左右省略空格。
    不要将多条语句写在同一行,尽管使用‘;’允许。
    if/for/while语句中,即使执行语句只有一句,也必须另起一行
    

    原则:避免不必要的空格

    命名习惯

    1.恒定量(常量)使用全大写与下划线:比如规定的不可更改的变量的值    
    2.私有变量使用前导下划线和小写,如:_message    
    3.一般的变量则应该:
        全小写,用下划线隔开
        表示类型的字母放在最前面
        作用或要完成的工作则在中间
        属于谁放在最后,或可省略
    
        例如:
            numpy_creat_data_set_test表示的意思是:
            该变量是numpy类型,被创建为一个数据集,用于测试(test这个函数的内部变量)   
    4.当一个变量被用于保存于布尔值时,做好使用is或has作为前缀,这样更易于理解    
    5.当一个变量被用于保存序列时,最好使用复数形式
    
    6.当一个变量被用于临时保存时,最好加上temp_的前缀
    
    7.当一个变量被用于作为字典时,应该使用显示名称,如一个用来保存个人地址的变量:person_address
    
    8.应当避免使用通用名称,现有名称(已有名称,变量i,j可以循环使用),
    避免关键字,非得使用可以使用后缀下划线
    
    9.类名使用驼峰命名法,当定义的是模块的私有类时,还可能有一个前导下划线
    
    10.类内的名称必须简明,精确,并足以从中理解类所完成的工作.
        常见的方法是表示其类型或特性的后缀:SQLEngine
    
    11.对于基类而言,可以使用一个Base或Abstract前缀,如:BaseCookie
    

    下面关于类中属性的命名规则:

    12.属性名称是用小写或者小写加上下划线命名的.大部分时候,它们表示对象的状态,可以是一个名词或一个形容词,在需要的时候也可以是一个小短语
    
    13.特殊方法是以两个下划线开始和结束的
    
    14.应尝试避免类及其特性名称之间的冗余,如:STMP.smtp_send()存在冗余
    

    作者:zzwwsun
    来源:CSDN
    原文:https://blog.csdn.net/weixin_41064957/article/details/80218121
    版权声明:本文为博主原创文章,转载请附上博文链接!

    相关文章

      网友评论

          本文标题:Python—PEP8编码和命名习惯

          本文链接:https://www.haomeiwen.com/subject/gymkfqtx.html