python编码要注意哪些规范？我们在学习python编码的时候，要有好的编码习惯，所有了解python编码规范很有必要。因此，下面就给大家来介绍一下关于缩进、行的最大长度、空行、命名约定、字符串引号、注释等使用的规范。

缩进

每一级缩进4个空格。

续行应该与包裹元素对齐，要么使用圆括号，方括号，花括号内的隐式行连接来垂直对齐，要么使用挂行缩进对齐。当使用挂行缩进对齐时，应该考虑到第一行不应该有参数，以及使用缩进以区分自己是续行。

• 对齐缩进（左右括号对齐）

def long_function_name(var_one, var_two,
                       var_three, var_four):
    print(var_one)

• 悬挂缩进

def long_function_name(
       var_one, var_two,
       var_three, var_four):
   print(var_one)

• 层级缩进

def long_function_name(
      var_one, var_two, var_three,
      var_four):
  print(var_one, var_two, var_three, var_four)

行的最大长度

所有行限制的最大字符数为79

没有结构化限制的大块文本（文档字符或者注释），每行的最大字符数限制在72。

with open("file1", "r") as f1, \
        open("file2", "r") as f2:
    f2.write(f1.read())

空行

顶层函数和类定义，前后用两个空行隔开。

类里面方法定义用一个空行隔开。

class Class01:
    pass


class Class02:
    def function_01(self):
        pass

    def function_02(self):
        pass

命名约定

变量命名

• 永远不要使用字母I (小写的L)， O （大写的O）， I （大写的I）作为单字符的变量名。
• 在有些字体里面，这些字符无法与数字0和1区分。如果想用I， 可使用L代替。

函数命名

• 函数名应该小写，如果想提高可读性可以用下划线分隔。
• 大小写混合仅在为了兼容原来主要以大小写混合风格的情况下使用，保持向后兼容。

类命名

•  类名一般使用首字母大写的约定。
• 在接口被文档化并且主要被用于调用的情况下，可以使用函数的命名风格代替。
• 注意：对于内置的变量命名有一个单独的约定：大部分内置变量是单个单词（或者两个单词连接在一起），首字母大写的命名法只用于异常名或者内部的常量。

类里面函数和方法参数

• 始终要将self作为实例方法的第一个参数。
• 始终要将cls作为类方法的第一个参数。
• 如果函数的参数名和已有关键字冲突，在最后加大意下划线比缩写或者随意拼写更好。因此class_比clss更好。

字符串引号

单引号和双引号字符串是相同的。PEP不会为这个给出建议。选择一条规则并坚持使用下去。当一个字符串中包含单引号或者双引号字符串的时候，使用和最外层不同的符号来避免使用反斜杠，从而提高可读性。

模块和包导入规范

• 命名规范 模块名称要短，使用小写，并避免使用特殊符号， 比如点和问号
• 因此请尽量保持模块名简单，以无需分开单词最佳（不推荐在两个单词之间使用下划线）

模块导入建议

示例	结果
from modu import *	差， 不清楚具体从模块中导入了哪些内容
from modu import sqrt	稍好
import modu	最佳 ， 调用的时候直接使用modu.sqrt能比较清楚的知道当前方法属于哪个模块。
import os \n import sys	推荐
import os, sys	不推荐
from subprocess import Popen, PIPE	也可以

__all__变量

• 如果模块中存在全局变量__all__， 那么通过__all__ from xxx import *导入时也只会导入__all__中指定的方法和变量，没有的话默认全部导入。

包

• 任意包含__init__.py文件的目录都被认为是一个python包。
• 因为导入包时会首先执行__init__.py文件
• 包中__init__.py文件中__all__变量的作用
• init.py文件中存在全局变量__all__， 通过from xxx import *导入时也只会导入__all__中指定的方法和变量，没有的话默认全部导入。

注释

与代码相矛盾的注释比没有注释还糟，当代码更改时，优先更新对应的注释！
注释应该是完整的句子。如果一个注释是一个短语或者句子，它的第一个单词应该大写，除非它是以小写字母开头的标识符（永远不要改变标识符的大小写！）。
如果注释很短，结尾的句号可以省略。块注释一般由完整句子的一个或多个段落组成，并且每句话结束有个句号。
在句尾结束的时候应该使用两个空格。
在非英语国家的python程序员，请使用英文写注释，除非120%的确信你的代码不会被使用其他语言的人阅读。

块注释

块注释通常适用于跟随它们的某些（或全部）代码，并缩进到与代码相同的级别。块注释的每一行开头使用一个#和一个空格（除非块注释内部缩进文本）。

块注释内部的段落通常只有一个#的空行分隔。

行内注释

有节制地使用行内注释

行内注释是与代码语句同行的注释。行内注释和代码至少要有两个空格分隔。注释由#和一个空格开始。

文档注释

要为所有的公共模块，函数，类和方法编写文档说明。

非公共的方法没有必要，但是应该有一个描述方法具体作用的注释。这个注释应该在def那一行之后。

PEP257描述了写出好的文档注释的相关约定。特别需要注意的是：多行文档注释使用的结尾三引号应该是自成一行，例如：

"""这是注释
注释的具体内筒
"""

 对于单行的文档说明，尾部的三引号应该和文档在同一行。

    关于python编码规范的内容就介绍到这，本文对新手学习Python有一定的帮助，需要的朋友可以了解看看，python编码规范。最后，想要了解更多，大家可以关注其它的相关文章。

文本转载自脚本之家

免责声明：本站发布的内容（图片、视频和文字）以原创、转载和分享为主，文章观点不代表本网站立场，如果涉及侵权请联系站长邮箱：mmqy2019@163.com进行举报，并提供相关证据，查实之后，将立刻删除涉嫌侵权内容。

猜你喜欢

• str和bytes什么区别，两者的转换是怎样

  Python3最重要的新特性之一是对字符串和二进制数据流做了明确的区,下面这篇文章主要给大家介绍了关于Python中bytes和str区别与联系的相关资料,需要的朋友可以参考下

• 如何应用Datawhale实现价格预测的效果

  此篇文章是关于Datawhale练习，代码完整，但由于该数据集中数据特征较少（39维），以下可作为少量特征情况下的分析。当特征数目过大（成千上万）时，需要继续学习。需要的朋友可以参考下

• Python中删除相同文件夹里的相似图片方法是什么

  这篇文章主要给大家介绍了关于利用python如何删除同一文件夹下相似的图片的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧

• Python中re模块的用法是怎样，有哪些要点

  正则表达式是用来匹配与查找字符串的,从网上爬取数据自然或多或少会用到正则表达式,python的正则表达式要先引入re模块,这篇文章主要给大家介绍了关于Python正则表达式re模块的相关资料,需要的朋友可以参考下

• Python算法分析是什么，怎么理解算法复杂度

  这篇文章主要介绍了python数据结构算法分析,在python的数据结构的章节中，我们上次学习到了python面向对象的思想，即我们想用程序来实现一个东西，我们需是用对象的特征来描述我们想构建的对象。感兴趣的小伙伴可以查看下面内容</P><P>