python 代码规范

Python注释（多行注释和单行注释）用法详解

Python单行注释

Python 中使用井号（‘#’）做为单行注释的符号，语法格式为：

[root@kube python]# cat demo.py 
# -*- coding:utf-8 -*-

#python script 注释#

print("test one")
[root@kube python]# 

 

 

Python多行注释

 

cat: de: No such file or directory
#-*- coding:utf-8 -*-

'''

1. 使用 3 个单引号分别做为注释的开头和结尾
2. 能够一次性注释多行内容
3. 这里面的内容所有是注释内容

　　代码注释块 测试

one 
'''

print("test one")
[root@kube python]# 

 

 

"""
使用 3 个双引号分别做为注释的开头和结尾
能够一次性注释多行内容
这里面的内容所有是注释内容
"""

 

 

 

Python中文编码声明注释

 

[root@kube python]# cat demo2.py 
#-*- coding:utf-8 -*-
#coding:utf-8
#coding=utf-8

print("编码声明注释的三种方")
[root@kube python]# 

 

 

 

 

Python缩进规则（包含快捷键）

在 Python 中，对于类定义、函数定义、流程控制语句、异常处理语句等，行尾的冒号和下一行的缩进，表示下一个代码块的开始，而缩进的结束则表示此代码块的结束。

注意，Python 中实现对代码的缩进，可使用空格或者 Tab 键实现。但不管是手动敲空格，仍是使用 Tab 键，一般状况下都是采用 4 个空格长度做为一个缩进量（默认状况下，一个 Tab 键就表示 4 个空格）

[root@kube python]# cat demo3.py 
#coding:utf-8

'''
代码缩进
体重指数BMI=体重/身高的平方（国际单位kg/㎡）
'''

height=float(input("输出身高m:"))
weight=float(input("输入体重kg:"))
bmi=weight/(height*height)   #计算 bmi


if bmi<18.5:
    print("BMI指数为: "+str(bmi) )
    print("体重太轻")
if bmi>=18.5 and bmi<24.9:
    print("BMI指数为："+str(bmi)) #输出BMI指数
    print("正常范围，注意保持")
if bmi>=24.9 and bmi<29.9:
    print("BMI指数为："+str(bmi)) #输出BMI指数
    print("体重太重")
if bmi>=29.9:
    print("BMI指数为："+str(bmi)) #输出BMI指数
    print("肥胖")
[root@kube python]# 

 

 

 

 

Python编码规范（PEP 8）

1.每一个 import 语句只导入一个模块，尽可能避免一次导入多个模块，例如：

 

#推荐
import os
import sys
#不推荐
import os,sys

2.不要在行尾添加分号，也不要用分号将两条命令放在同一行，例如：

#不推荐
height=float(input("输入身高：")) ; weight=fioat(input("输入体重：")) ;

 

3.建议每行不超过 80 个字符，若是超过，建议使用小括号将多行内容隐式的链接起来，而不推荐使用反斜杠 \ 进行链接。例如，若是一个字符串文本没法实现一行彻底显示，则可使用小括号将其分开显示，代码以下：

[root@kube python]# cat demo4.py 
#coding:utf-8

s1=(" python 代码规范，每行最好不要超过80 个字符，换行使用() "
"推荐" )

s2=("python 代码规范,\
    不建议使用反斜杠")

print(s1)
print(s2)
[root@kube python]# 

 

 

 

Python标识符命名规范

Python 中标识符的命名不是随意的，而是要遵照必定的命令规则，好比说：

1. 标识符是由字符（A~Z 和 a~z）、下划线和数字组成，但第一个字符不能是数字。
2. 标识符不能和 Python 中的保留字相同。有关保留字，后续章节会详细介绍。
3. Python中的标识符中，不能包含空格、@、% 以及 $ 等特殊字符。
   例如，下面所列举的标识符是合法的：

 

1. 例如，下面所列举的标识符是合法的：

   UserID
   name
   mode12
   user_age

    

   如下命名的标识符不合法：

   4word    #不能以数字开头
   try          #try是保留字，不能做为标识符
   $money #不能包含特殊字符

    

2. 在 Python 中，标识符中的字母是严格区分大小写的，也就是说，两个一样的单词，若是大小格式不同，多表明的意义也是彻底不一样的。好比说，下面这 3 个变量之间，就是彻底独立、毫无关系的，它们彼此之间是相互独立的个体。
   

   number = 0
   Number = 0
   NUMBER = 0

    

3. Python 语言中，如下划线开头的标识符有特殊含义，例如:
   • 以单下划线开头的标识符（如 _width），表示不能直接访问的类属性，其没法经过 from...import* 的方式导入；
   • 以双下划线开头的标识符（如__add）表示类的私有成员；
   • 以双下划线做为开头和结尾的标识符（如 __init__），是专用标识符。
   所以，除非特定场景须要，应避免使用如下划线开头的标识符。

另外须要注意的是，Python 容许使用汉字做为标识符，例如:

你好 = "http://nihao.net"

但咱们应尽可能避免使用汉字做为标识符，这会避免遇到不少奇葩的错误。

标识符的命名，除了要遵照以上这几条规则外，不一样场景中的标识符，其名称也有必定的规范可循，例如：

当标识符用做模块名时，应尽可能短小，而且所有使用小写字母，可使用下划线分割多个字母，例如 game_mian、game_register 等。
当标识符用做包的名称时，应尽可能短小，也所有使用小写字母，不推荐使用下划线，例如 com.mr、com.mr.book 等。
当标识符用做类名时，应采用单词首字母大写的形式。例如，定义一个图书类，能够命名为 Book。
模块内部的类名，能够采用 "下划线+首字母大写" 的形式，如 _Book;
函数名、类中的属性名和方法名，应所有使用小写字母，多个单词之间能够用下划线分割；
常量命名应所有使用大写字母，单词之间能够用下划线分割；