zoukankan      html  css  js  c++  java
  • PEP8规范

    因为在开发过程中读代码多余写代码,所以保持代码的一致性很重要,,下边就看看都有哪些代码规范

    一、代码布局

    缩进:四个空格
    
    方法中多参数的悬挂或者垂直缩进:在IDE中一行到末尾时选择换行???,并在下一行多空格两个,避免与下一级的语句冲突
    
    if中多条件连接:跟上面多参基本一致
    
    空格 or tab的选择:用空格,在IDE中自动使用空格作为换行,如果自己在vim中编辑时,要用空格,保持一致
    
    最大行宽:所有行的最大行宽为79个字符,如果是文本(如注释)最大为72字符
    
    空行:1.正常使用,作为分割逻辑快,不要使用过多的空行;2.在顶层函数与定义间用两行空行
    
    文件编码的注意事项:py2中,默认是ascii编码,而py3中是utf8编码,用的是py2,所以尽量避免出现中文,保持ascii么,还是规定编码为utf8???
    
    标准库或者普通库的导入:1.导入一个库在单独行;2.导入始终在文件的顶部,在模块注释和文档字符串之后,在模块全局变量和常量之前;3.导入顺序:标准库,第三方库,本地库。导入之间要有空行;4. 尽量使用绝对路径导入???

    二、字符串引用

    python中双引号与单引号字符串是相同的,而且尽量避免在字符串中写反斜杠''

    三、表达式和语句中的空格

    不能使用空格的情况:1.括号内;2.逗号,冒号,分号前;3.索引切片操作符冒号前后???;4.函数名与括号之间;5.列表名与中括号之间;6.优先级较高的运算符左右,比如*;7.方法中默认参数赋值操作符左右;8.
    
    要使用空格的情况:1.二元操作符左右;
    
    冒号一般前面没有,后面有
    
    避免使用''作为连接两个语句,尽量在一行不写两条语句

    四、注释

    在更新代码时,优先更新注释,不对应的注释比没注释还要糟糕
    
    注释块用#写,每一行间用一个#隔开
    
    注释块内的段落用仅包含单个 '#' 的行分割
    
    文档字符串,用于公共模块、函数、类和方法中,必须写上
    
    '#'后面跟着一个空格

    五、版本标签

    如果你必须在源文件中包含git、Subversion、CVS或RCS crud信息,放置在模块的文档字符串之后,任何其他代码之前,上下各用一个空行

    六、命名规定

    前面有单下划线:1.弱内部标志:from M import不会导入的对象
    
    后面有单下划线:1.避免与关键字冲突
    
    前面有双下划线:1.对类这样命名的时候,会触发名字重整
    
    避免使用的名字:1.'i',小写i;2.'I',大写i;3.'O',大写o;
    
    模块名、包名:模块名全部小写,用下划线连接;包名也是小写,但是不用下划线
    
    类名:CapWord命名,也就是pascal风格,首字母大写
    
    异常名:在类名后添加Error
    
    全局变量名:变量尽量只用于模块内部,约定类似函数。对设计为通过 "from M import " 来使用的模块,应采用 all 机制来防止导入全局变量;或者为全局变量加一个前置下划线。???
    
    函数名:小写,必要时添加下划线
    
    函数和方法参数:实例方法第一个参数是 'self'。类方法第一个参数是 'cls'。
    
    常量命名:大写字母加下划线
    
    继承命名:公开属性应该没有前导下划线。
    
    如果公开属性名和保留关键字冲突,可以添加后置下划线
    
    简单的公开数据属性,最好只公开属性名,没有复杂的访问/修改方法,python的Property提供了很好的封装方法。 d.如果不希望子类使用的属性,考虑用两个前置下划线(没有后置下划线)命名。

    七、一些建议

    +尽量写为.join()
    
    none值比较尽量用is,is not 而不是用==
    
    异常类继承自Exception,而不是BaseException。
    
    Python2中用" raise ValueError('message')"代替"raise ValueError, 'message'"
    
    捕获异常时尽量指明具体异常,而不是空"except:"子句
    
    Python 2.6以后建议用as显示绑定异常名
    
    函数或者方法在没有返回时要明确返回None。
    
    使用字符串方法而不是string模块。
    
    使用使用 .startswith()和.endswith()代替字符串切片来检查前缀和后缀
    
    使用isinstance()代替对象类型的比较:
    
    对序列(字符串、列表 、元组), 空序列为false:
    
    字符串后面不要有大量拖尾空格。
    
    不要用 == 进行布尔比较
  • 相关阅读:
    ubuntu的apt
    sudo命令
    MySQL导出数据到csv文件
    MySQL导出数据到文件报错
    git_backup.py gitlab项目备份
    java中图像与数组转换
    mongodb转elasticsearch
    impyla-0.14.2.2安装注意事项
    python3.7.3升级 with-openssl openssl-1.0.2a
    hadoop自带性能测试
  • 原文地址:https://www.cnblogs.com/52-qq/p/8536002.html
Copyright © 2011-2022 走看看