首页 > 其他分享 >PEP8的规范详细

PEP8的规范详细

时间:2022-09-24 13:46:50浏览次数:43  
标签:缩进 Python 代码 规范 PEP8 详细 import 应该

PEP8规范详细

image

首先我们先了解一下PEP8规范是什么?

PEP是Python Enhancement Proposal的缩写,通常翻译为“Python增强提案”。

每个PEP都是一份为Python社区提供的指导Python往更好的方向发展的技术文档,其中的第8号增强提案(PEP 8)是针对Python语言编订的代码风格指南。(好专业emmm。。。。)

尽管我们可以在保证语法没有任何问题的前提下随意书写Python代码,但是呢在实际开发的过程中,采用一致的风格书写出可读性强的代码是每个专业的程序员应该做到的事情,也是每个公司的编程规范中会提出的要求,这些在多人协作开发一个项目(团队开发)的时候显得尤为重要。

image

PEP8规范相关内容

我们可以从Python官方网站的PEP 8链接中找到该文档,下面我们对该文档的关键部分做一个简单的总结。

1.空格的使用

使用空格来表示缩进而不要用制表符(Tab)。这一点对习惯了其他编程语言的人来说简直觉得不可理喻,因为绝大多数的程序员都会用Tab来表示缩进,但是要知道Python并没有像C/C++或Java那样的用花括号来构造一个代码块的语法,在Python中分支和循环结构都使用缩进来表示哪些代码属于同一个级别,鉴于此Python代码对缩进以及缩进宽度的依赖比其他很多语言都强得多。在不同的编辑器中,Tab的宽度可能是2、4或8个字符,甚至是其他更离谱的值,用Tab来表示缩进对Python代码来说可能是一场灾难。

2.和语法相关的每一层缩进都用4个空格来表示。
3、每行的字符数不要超过79个字符,如果表达式因太长而占据了多行,除了首行之外的其余各行都应该在正常的缩进宽度上再加上4个空格。
4、函数和类的定义,代码前后都要用两个空行进行分隔。
5、在同一个类中,各个方法之间应该用一个空行进行分隔。
6、二元运算符的左右两侧应该保留一个空格,而且只要一个空格就好。

image

标识符命名

PEP8倡导用不同的命名风格来命名Python中不同的标识符,以便在阅读代码时能够通过标识符的名称来确定该标识符在Python中扮演了怎样的角色(在这一点上,Python自己的内置模块以及某些第三方模块都做得并不是很好)。

1、变量、函数和属性应该使用小写字母来拼写,如果有多个单词就使用下划线进行连接。
2、类中受保护的实例属性,应该以一个下划线开头。
3、类中私有的实例属性,应该以两个下划线开头。
4、类和异常的命名,应该每个单词首字母大写。
5、模块级别的常量,应该采用全大写字母,如果有多个单词就用下划线进行连接。
6、类的实例方法,应该把第一个参数命名为self以表示对象自身。
7、类的类方法,应该把第一个参数命名为cls以表示该类自身。

image

表达式和语句

​ 在Python之(可以使用import this查看)中有这么一句名言:“There should be one-- and preferably only one --obvious way to do it.”,翻译成中文是“做一件事应该有而且最好只有一种确切的做法”,这句话传达的思想在PEP 8中也是无处不在的。
image

1、采用内联形式的否定词,而不要把否定词放在整个表达式的前面。例如if a is not b就比if not a is b更容易让人理解。
2、不要用检查长度的方式来判断字符串、列表等是否为None或者没有元素,应该用if not x这样的写法来检查它。
3、就算if分支、for循环、except异常捕获等中只有一行代码,也不要将代码和if、for、except等写在一起,分开写才会让代码更清晰。
4、import语句总是放在文件开头的地方。
5、引入模块的时候,from math import sqrt比import math更好。
6、如果有多个import语句,应该将其分为三部分,从上到下分别是Python标准模块、第三方模块和自定义

image

标签:缩进,Python,代码,规范,PEP8,详细,import,应该
From: https://www.cnblogs.com/qiguanfusu/p/16725491.html

相关文章

  • vue3 的 ref、isRef、toRef、toRefs、toRaw 详细介绍
    ref、isRef、toRef、toRefs、toRaw看着一堆类似的东西,一个头两个大,今天整理一篇文章详细介绍它们的功能及区别。1、refref属性除了能够获取元素外,也可以使用ref函数,......
  • PEP8规范
    PEP8简介PEP8编码规范是一种非常优秀的编码规范,也得到了Python程序员的普遍认可,如果实践中或者项目中没有统一的编码规范,建议尽量遵循PEP8编码规范,当然如果项目中已有了......
  • PEP8规范解释说明
    PEP8规范解析内容概要:1.PEP8规范是什么?2.PEP8相关内容1.PEP8规范是什么PEP是PythonEnhancementProposal的缩写,翻译为:“Python增强提案”每个PEP都是一份为Python......
  • python注释、变量、数据类型详细
    1.python注释什么是注释?注释是对代码的解释说明,写注释是为了下次来看能更快的理解,抵抗遗忘。单行注释:文字之前加警号pycharm中有快捷键ctrl+?#这是单行注释......
  • 【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......
  • 如何在 XJOI 订正卡常题(详细揭秘)
    在XJOI订正卡常题是怎么回事呢?那么卡常题为什么会被在XJOI订正,相信大家都很好奇。大家可能会感到很惊讶,卡常题为什么会被在XJOI订正呢?但事实就是这样,小编也感到非常......
  • 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......