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;
函數名、類中的屬性名和方法名，應所有使用小寫字母，多個單詞之間能夠用下劃線分割；
常量命名應所有使用大寫字母，單詞之間能夠用下劃線分割；