Heim  >  Artikel  >  Backend-Entwicklung  >  Was sind die Codierungsstandards in Python?

Was sind die Codierungsstandards in Python?

WBOY
WBOYnach vorne
2023-05-09 15:22:071617Durchsuche

编码规范

Python 编码规范重要性的原因用一句话来概括就是:统一的编码规范可以提高开发效率。

ps.python的代码编写基本上都要遵循PEP8的风格

1、分号

不要在行尾加分号, 也不要用分号将两条命令放在同一行。

2、命名

module_name, package_name, ClassName, method_name

应该避免的名称

  1. 单字符名称, 除了计数器和迭代器.

  2. 包/模块名中的连字符(-)

  3. 双下划线开头并结尾的名称(Python保留, 例如__init__)

命名约定

  1. 所谓"内部(Internal)"表示仅模块内可用, 或者, 在类内是保护或私有的.

  2. 用单下划线(_)开头表示模块变量或函数是protected的(使用import * from时不会包含)

  3. 用双下划线(__)开头的实例变量或方法表示类内私有.

  4. 将相关的类和顶级函数放在同一个模块里. 不像Java, 没必要限制一个类一个模块.

  5. 对类名使用大写字母开头的单词(如CapWords, 即Pascal风格), 但是模块名应该用小写加下划线的方式(如lower_with_under.py). 尽管已经有很多现存的模块使用类似于CapWords.py这样的命名, 但现在已经不鼓励这样做, 因为如果模块名碰巧和类名一致, 这会让人困扰.

3、行长度

每行不超过80个字符

以下情况除外:

  1. 长的导入模块语句注释里的URL

  2. 不要使用反斜杠连接行。

Python会将 圆括号, 中括号和花括号中的行隐式的连接起来 , 你可以利用这个特点. 如果需要, 你可以在表达式外围增加一对额外的圆括号。

推荐: 

foo_bar(self, width, height, color='black', design=None, x='foo',
             emphasis=None, highlight=0)
 
     if (width == 0 and height == 0 and
         color == 'red' and emphasis == 'strong'):

如果一个文本字符串在一行放不下, 可以使用圆括号来实现隐式行连接:

x = ('这是一个非常长非常长非常长非常长 '
     '非常长非常长非常长非常长非常长非常长的字符串')

4、缩进

用4个空格来缩进代码

绝对不要用tab, 也不要tab和空格混用. 对于行连接的情况, 你应该要么垂直对齐换行的元素(见 :ref:`行长度 44761aa7499d6dd57277a30698412b6d` 部分的示例), 或者使用4空格的悬挂式缩进(这时第一行不应该有参数):

       # 与起始变量对齐
       foo = long_function_name(var_one, var_two,
                                var_three, var_four)
 
       # 字典中与起始值对齐
       foo = {
           long_dictionary_key: value1 +
                                value2,
           ...
       }

5、空行

顶级定义之间空两行, 方法定义之间空一行

顶级定义之间空两行, 比如函数或者类定义. 方法定义, 类定义与第一个方法之间, 都应该空一行. 函数或方法中, 某些地方要是你觉得合适, 就空一行.

6、空格

按照标准的排版规范来使用标点两边的空格

括号内不要有空格.

按照标准的排版规范来使用标点两边的空格

正确示范: spam(ham[1], {eggs: 2}, [])
错误示范: spam( ham[ 1 ], { eggs: 2 }, [ ] )

7、类

类应该在其定义下有一个用于描述该类的文档字符串. 如果你的类有公共属性(Attributes), 那么文档中应该有一个属性(Attributes)段. 并且应该遵守和函数参数相同的格式.

class SampleClass(object):
    """Summary of class here.
    Longer class information....
    Longer class information....
    Attributes:
        likes_spam: A boolean indicating if we like SPAM or not.
        eggs: An integer count of the eggs we have laid.
    """
 
    def __init__(self, likes_spam=False):
        """Inits SampleClass with blah."""
        self.likes_spam = likes_spam
        self.eggs = 0
 
    def public_method(self):
        """Performs operation blah."""

8、块注释和行注释

最需要写注释的是代码中那些技巧性的部分. 如果你在下次 代码审查 的时候必须解释一下, 那么你应该现在就给它写注释. 对于复杂的操作, 应该在其操作开始前写上若干行注释. 对于不是一目了然的代码, 应在其行尾添加注释.

# We use a weighted dictionary search to find out where i is in
# the array.  We extrapolate position based on the largest num
# in the array and the array size and then do binary search to
# get the exact number.
 
if i & (i-1) == 0:        # true iff i is a power of 2

为了提高可读性, 注释应该至少离开代码2个空格.

另一方面, 绝不要描述代码. 假设阅读代码的人比你更懂Python, 他只是不知道你的代码要做什么.

# BAD COMMENT: Now go through the b array and make sure whenever i occurs
# the next element is i+1

9、字符串

正确示范: 
     x = a + b
     x = '%s, %s!' % (imperative, expletive)
     x = '{}, {}!'.format(imperative, expletive)
     x = 'name: %s; score: %d' % (name, n)
     x = 'name: {}; score: {}'.format(name, n)
错误示范: 
    x = '%s%s' % (a, b)  # use + in this case
    x = '{}{}'.format(a, b)  # use + in this case
    x = imperative + ', ' + expletive + '!'
    x = 'name: ' + name + '; score: ' + str(n)

10、导包

每个导入应该独占一行

正确示范: 
import os 
import sys
错误示范:   import os, sys

导入总应该放在文件顶部, 位于模块注释和文档字符串之后, 模块全局变量和常量之前. 导入应该按照从最通用到最不通用的顺序分组:

标准库导入第三方库导入应用程序指定导入

【总结】

1.命名

  1. 函数、变量及属性都应该用小写单词拼写,只见用_连接,不遵循驼峰命名法

  2. 类与异常应该首字母大写,不要用_连接

  3. 受保护的实例属性,应以单下划线开头

  4. 实例的私有属性,应以双下划线开头

  5. 模块级别的变量单词都要大写,中间以单下划线隔开

  6. 变量要尽可能有意义

2.空白

  1. 和语法相关的每一层缩进都用4个空格表示

  2. 赋值时等号两边都要有一个空格

  3. 每一行所占用的字符数应不超过79,实际操作中应当尽量不让代码编辑器的行滚动条显示出来

  4. Bei der Verwendung von Funktionen für die funktionale Programmierung sollten zwischen Funktionen zwei Leerzeilen stehen eine Leerzeile zwischen den Funktionen sein

  5. Wenn sich die Funktion und die Klasse auf derselben Ebene befinden, sollten zwischen ihnen zwei Leerzeilen stehen

  6. Bei langen Ausdrücken, die die angegebene Anzahl von Zeichen pro Zeile überschreiten, sollten Sie zum Einrücken die Eingabetaste drücken. Normalerweise müssen alle anderen Zeilen mit Ausnahme der ersten Zeile erneut um 4 Leerzeichen eingerückt werden

    #🎜🎜 #
  7. 3. Aussage

Verwenden Sie bei der Beurteilung, ob eine Variable Keine, Falsch oder Wahr ist, nicht ==, sondern verwenden Sie ist zum Beispiel, wenn a None ist

  1. Die Importanweisung sollte am Anfang des Satzes stehen. Versuchen Sie beim Importieren, den absoluten Import anstelle des relativen Imports zu verwenden , und es ist am besten, beim Importieren einen bestimmten Teil des entsprechenden Moduls anzugeben, z. B. from datetime import datetime

  2. Beim Importieren von Modulen sollten sie angegeben werden nach Standardbibliotheksmodulen, Drittanbietermodulen und selbst verwendeten Modulen klassifiziert werden

    #🎜🎜 #

  3. Wenn festgestellt wird, dass der Container nicht leer ist, sollte der if-Containername verwendet werden, zum Beispiel,Listen = [] wenn Listen
  4. in Inline-Form Setzen Sie das negative Wort nicht vor den gesamten Ausdruck. Beispielsweise sollte es sein, wenn a ist not None statt if not a is None
  5. 4. Kommentare

  6. Für funktionale Beschreibungen bestimmter wichtiger Codeblöcke, einzeilige Kommentare sollten

für das gesamte Modul verwendet werden. Die Beschreibung der Funktion sollte mehrzeilige Kommentare verwenden

    # 🎜🎜#
  1. Die detaillierte Beschreibung der Funktion und Verwendung der Klasse oder Funktion sollte die Dokumentationszeichenfolge

    # 🎜🎜#
  2. Bitte verwenden Sie für Python so viel wie möglich Englisch Kommentare

Das obige ist der detaillierte Inhalt vonWas sind die Codierungsstandards in Python?. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!

Stellungnahme:
Dieser Artikel ist reproduziert unter:yisu.com. Bei Verstößen wenden Sie sich bitte an admin@php.cn löschen