首页 > 其他分享 >PEP8规范

PEP8规范

时间:2022-09-24 10:47:10浏览次数:58  
标签:__ 注释 下划线 规范 空格 PEP8 使用 语句

PEP8简介

PEP8编码规范是一种非常优秀的编码规范,也得到了Python程序员的普遍认可,如果实践中或者项目中没有统一的编码规范,建议尽量遵循PEP8编码规范,当然如果项目中已有了自身编码规范,应该优先遵循自身编码规范。哪怕原先代码风格看起来很糟糕,也要尽量与源代码保持一致。原文地址:https://blog.csdn.net/ratsniper/article/details/78954852

一 缩进和对齐

  1. 语法缩进
语法上的缩进使用4个空格(参数对齐等不一定要用4个空格),不要混用制表符与空格,Python2程序在命令行运行时,使用-t可以发出制表符与空格混用的警告,而使用-tt就会使这些警告变成错误提示了。
  1. 行宽
代码行宽限制在79个字符(也可以是99个字符),文档和注释限制在72个字符
  1. 对齐
当圆括号、方括号和花括号中的元素需要换行时,元素应该垂直对齐,而且如果下一条语句需要缩进时,比如if的条件语句和要执行的代码块,这些换行的元素应该使用更多的缩进来区分下面的缩进
  1. 换行
代码换行时应该优先使用圆括号、方括号和花括号中的隐士续行,视情况使用反斜杠\来进行换行
  1. 二元运算符
在二元云算法的换行时推荐以二元运算符作为新行的开始
  1. 多条语句同行
即使是简单的语句,即使可以使用分号,但是不推荐写在同一行,比如简单的if/for/while语句也应该分行写

二 空行

  1. 顶级定义
顶级函数和类定义的前后使用两个空行隔开
  1. 类方法
类中方法的定义使用一个空行隔开
  1. 逻辑分段
函数中的功能组合逻辑段使用空行来隔开(视情况灵活运用)

三 import语句

  1. import * 和from xxx import *
这种通配符星号的用法应该尽量避免使用
  1. import xxx
这种语句有多个时,应该分开导入,不推荐使用import xxx,yyy
  1. from xxx import x,xx
这种形式可以一次导入多个而不用分行
  1. 普通导入
导入应该在文档字符串和注释之后,在全局变量和常量定义之前
  1. 导入顺序
导入顺序应该是标准库,第三方库,以及本地模块,且需要加空行分隔
  1. 导入路径
导入应该尽量使用绝对路径或使用显示的相对路径也是可行的(如: from . import xxx),尽量避免隐式的相对路径
  1. 双下划线变量导入
在像__version__、__author__等模块级变量的导入应该在文档和注释之后,在import语句之前

四 空格

  1. 括号等之后的空格
避免紧跟在括号、中括号和大括号之后的空格,例如: func( list_[ 1 ], { 'age': 18 })。应该省去不必要的空格func(list_[1],{'age': 18})
  1. 逗号等之前的空格
避免紧跟在逗号、分号和冒号之前的空格,例如:a , b = b , a,应该省去不必要的空格a, b = b, a
  1. 切片中的空格
切片的冒号左右两边应该有相同的空格,切片的下标如果是数字或变量,建议冒号两边不用空格,如果下标是多个变量的表达式或者函数表达式,则建议冒号两边使用一个空格分隔
  1. 行尾的空格
避免在行尾添加空格,比如在换行符反斜杠\后有空格的话,那这个反斜杠\就不是换行符了,因为行尾是空格而不是反斜杠\
  1. 二元运算符
除了函数传参和函数指定默认值等特殊情况外,应该总是在二元运算符的两边添加一个空格,如果一个表达式有多个二元运算符(如:+-*/),那么高优先级的二元运算符两边不用空格,低优先级两边添加一个空格,如: x = a*b + c/d

五 注释

  1. 修改注释
修改代码时一定修改对应的注释,千万不要留下与代码不对应的,甚至是错误的注释,视情况甚至可以删掉注释也不留错误的注释
  1. 行注释
使用一个#和一个空格开始,并且与注释的代码具有相同缩进,如果需要使用行注释写多段意思的注释,可以使用一个空行注释(即这一行只有一个#)来分隔不同意思的段落
  1. 代码行之后的注释
应该与前面的代码间隔至少两个空格,然后也是以使用一个#和一个空格开始,但是这种注释应该尽量少使用,不必要的话就不用
  1. 文档注释
应该为所有公共的模块、函数、类和方法编写文档注释,一般使用三个双引号写文档注释,且如果是单行注释,则结尾的三引号应该与注释内容同行,如果是多行注释,则结尾三引号应该单独一行

六 命名

  1. 旧代码
如果原有的代码与命名规范不一样,应该与原有代码保持一致
  1. API
暴露的API或者给别人使用的API应该以使用场景来命名,而不是实现原理命名
  1. 首字母大写加下划线
这种命名风格不可取,比如Capitalized_Words_With_Underscores
  1. 单下划线开头
这种命名为弱“内部使用” 指示器,即模块内非公有(“protected”),比如在使用from xxx import * 语句时是不会导入单下划线开头的对象的
  1. 单下划线结尾
这种命名风格是为了避免与Python内部关键字冲突的一种约定
  1. 双下划线开头
当在类中以双下划线开头定义时,调用它的时候会在前面加上"_ClassName",如调用类A中的属性__a时,__a就变成了_A__a,这样子类就不可以随便调用这个属性了,可以认为它是“私有”的,但Python中没有“私有”的说法,因为依然可以通过A._A__a去访问属性
  1. 双下划线开头和结尾
为模块和系统级变量,比如__name__、__init__等,我们自己应该永远避免使用这种命名风格
  1. 单字符变量
永远要使用O(大写的O),l(小写的L)和I(大写的I),因为有些字体中无法区分它们是数字0和1还是英文字母L和O
  1. 包名和模块名
使用简短全小写的名称,包名不建议使用下划线,模块名为了提高可读性可以使用下划线
  1. c/c++扩展模块
使用c/c++编写的扩展模块需要在模块名称加一个下划线前缀,如:_socket
  1. 类名
首字母大写
  1. 异常名
异常一般也是类,所以首字母也是大写,如果异常确实是一个错误,那需要在类名后加上“Error”后缀
  1. 函数名
全小写,为了提高可读性也可以使用下划线,大小写混合的情况只限于为了与原来的代码兼容的情况
  1. 全局变量
只在模块内使用的全局变量和普通变量一样定义,但是需要注意使用"from xxx import *"的xxx模块中的全局变量应该使用单下划线开头防止内部接口或变量的对外暴露
  1. 实例变量
非公有方法和实例变量使用单下划线开头(“protected”),双下划线开头会触发Python的命名转换规则(在前面加上"_ClassName")以避免和子类命名的冲突
  1. 常量
常量通常是模块级的,使用全大写和下划线配合

七 编程建议

  1. 字符(串)连接
尽量避免使用str1 += str2或str1 = str1 + str2的方式连接字符(串),建议使用字符串方法join()方法来连接字符(串)
  1. 单例对象判断
在于如None这样的单例对象进行判断时,应该使用is None或者is not None来进行判断
  1. 自定义异常
自定义异常应该继承自Exception,而不是BaseException
  1. try/except
在try中只填充可能出错的代码,不要一股脑把全部代码放进去
  1. return语句
除非函数中没有return语句,如果函数中有return语句,那么在其他可能结束的情况也显示的使用return语句,如果其他情况确实没有值要返回(如运行到了函数结束处,却不需要返回任何值),也要使用return None显示指明
  1. startswith/endswith
判断字符串开头前缀或结尾后缀时,使用字符串本身的startswith/endswith,不用字符串的切割来进行判断
  1. 对象类型的比较
对象类型的比较使用isinstance,而不是type
  1. “空”值判断
对于空字符串、空列表、空字典等的判断,直接使用本身来进行布尔值判断,如空字符串使用if str1: pass,而不是if str1 == '': pass

标签:__,注释,下划线,规范,空格,PEP8,使用,语句
From: https://www.cnblogs.com/winter-yu1989/p/16725079.html

相关文章

  • PEP8规范解释说明
    PEP8规范解析内容概要:1.PEP8规范是什么?2.PEP8相关内容1.PEP8规范是什么PEP是PythonEnhancementProposal的缩写,翻译为:“Python增强提案”每个PEP都是一份为Python......
  • 【Django-rest-framework框架】第01回 drf入门规范
    目录1.前后端开发模式1.1前后端混合开发1.2前后端分离1.3流程图1.4前端的后台管理模板2.API接口2.1本质2.2四大特点2.3模拟3.接口测试工具postman4.RESTfulAPI......
  • PEP8格式规范
    1.空格的使用 #1、使用空格来表示缩进而不要用制表符(Tab)。这一点对习惯了其他编程语言的人来说简直觉得不可理喻,因为绝大多数的程序员都会用Tab来表示缩进,但是要知道Py......
  • pycharm,语法注释,部分PEP8规范,常量与变量的基本使用,几个数据类型
    pycharm下载与使用网址:https://www.jetbrains.com/pycharm/download/#section=windows1.该软件分为收费版和免费版免费版功能太少(community)我们尽量使用收费版(prof......
  • API接口与drf规范
    前后端开发模式1.前后端混合前端写好静态html页面,后端使用模板语法进行渲染,然后在在对接,遇到问题返回给前端进行修改,这要求后端人员会一些HTML、JS等前端语言,这种模式让......
  • 前后端开发模式、API接口、接口测试工具postman、restful规范、序列化和反序列化、dja
    目录前后端开发模式一、两种模式1.传统开发模式:前后端混合开发1.1.缺点:2.前后端分离开发模式2.1.特点3.补充老刘的相关博客:二、API接口1.作用2.说明三、接口测试工具postm......
  • PEP8规范
    PEP8规范一PEP8规范是什么?PEP是PythonEnhancementProposal的缩写,通常翻译为“Python增强提案”尽管我们可以在保证语法没有问题的前提下随意书写Python代码,但是在实......
  • PEP8规范
    python代码编写规范:1.单行注释如果在代码之后,#与代码之间要空两格,#与注释之间空一格。2.如果内容与井号自成一行,那么井号和内容之间空一格。3.列表逗号与后面的元素之......
  • PEP8规范
    pycharm中很多时候会有各种颜色提示还有波浪线只要不是红线一般都不影响代码运行一.PEP8的规范是什么?​PEP是PythonEnhancementProposal的缩写,通常翻译为“Py......
  • API接口、接口测试工具postman、restful规范、序列化与反序列化、djangorestframework
    API接口通过网络,规定了前台后台信息交流规则的url链接,也就是前后台信息交互的媒介API接口的样子url:长得像返回数据的url链接https://api.map.baidu.com/place/v2/s......