码迷,mamicode.com
首页 > 编程语言 > 详细

Python中的编码风格

时间:2021-06-22 18:38:00      阅读:0      评论:0      收藏:0      [点我收藏+]

标签:单词   scores   好的   lse   冒号   调用   大写   代码   逻辑运算   

详细内容参照:https://www.python.org/dev/peps/pep-0008/

要点提取:

1、使用 4 个空格缩进,严禁Tab和空格两者混用,如果使用 tab 缩进,设定tab 为 4 个空格。

2、4 个空格是小缩进(允许更大的嵌套深度)和大缩进(更容易阅读)之间的一个很好的折衷。Tab会引起混乱,最好不要使用。

3、换行,使其不超过 79 个字符,这有助于使用小显示器的用户,并可以在较大的显示器上并排放置多个代码文件。

4、使用空行来分隔函数和类,以及函数内部的较大代码块。

5、如果可能的话,将注释写在一行中。

6、使用文档字符串,文档字符串使用惯例:它的首行简述函数功能,第二行空行,第三行为函数的具体描述。如:

def printMax(x,y):
    ‘‘‘打印两个数中的最大值。
    
    两个值必须都是在整形数。‘‘‘
    x=int(x)
    y=int(y)
    if x>y:
        print(x,最大)
    else:
        print(y,最大)
        
printMax(3,5)
print (printMax.__doc__) # 调用 doc 

7、在运算符周围和逗号后使用空格,但不要直接在括号结构内使用:.f(1, 2) g(3, 4)

  注意点: 

在二元算术、逻辑运算符前后加空格:如:a = b + c;
在一元前缀运算符后不加空格,如:
if !flg: pass;
“:”用在行尾时前后皆不加空格,如分枝、循环、函数和类定义语言;用在非行尾时两端加空格,如:
  dict 对象的定义:d
= {key : value}   括号(含圆括号、方括号和花括号)前后不加空格,如:do_something(arg1, arg2),而不是:do_something( arg1, arg2 ) 不要在逗号、分号、冒号前面加空格,但应该在它们后面加(除了在行尾)
不要用空格来垂直对齐多行间的标记,因为这会成为维护的负担(适用于:,
#,=等)

8、一致地命名您的类和函数,约定的是:

类:单词首字母总是大写,私有类可以下划线开头。如:UpperCamelCase。

函数:函数名一律小写,若有多个单词用下划线隔开。如:lowercase_with_underscores。另外,私有函数下划线开头 。如:_lowercase_with_underscores

9、如果您的代码打算在国际环境中使用,请不要使用花哨的编码。在任何情况下,Python 的默认值、UTF-8 甚至纯 ASCII 都效果最好。

同样,如果使用不同语言的人阅读或维护代码的可能性很小,则不要在标识符中使用非 ASCII 字符。

 

 

Python中的编码风格

标签:单词   scores   好的   lse   冒号   调用   大写   代码   逻辑运算   

原文地址:https://www.cnblogs.com/wxinyu/p/14919012.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!