1.註釋 合理的代碼註釋應該占源代碼的 1/3 左右,Python 語言允許在任何地方插入空字元或註釋,但不能插入到標識符和字元串中間。 在 Python 中,通常包括 3 種類型的註釋,分別是單行註釋、多行註釋和中文編碼聲明註釋: 單行註釋: Python 中使用井號( # )作為單行註釋的符號, ...
1.註釋
合理的代碼註釋應該占源代碼的 1/3 左右,Python 語言允許在任何地方插入空字元或註釋,但不能插入到標識符和字元串中間。 在 Python 中,通常包括 3 種類型的註釋,分別是單行註釋、多行註釋和中文編碼聲明註釋:-
單行註釋:
1 print('hello world') # 這是一條註釋
-
多行註釋:
1 st = ''' 2 日照香爐生紫煙, 3 遙看瀑布掛前川。 4 飛流直下三千尺, 5 疑是銀河落九天。 6 '''
-
中文編碼聲明註釋:
1 # -*- coding: UTF-8 -*-
2.縮進規則
Python 採用代碼縮進和冒號( : )來區分代碼塊之間的層次。 對於類定義、函數定義、流程式控制制語句、異常處理語句等,行尾的冒號和下一行的縮進,表示下一個代碼塊的開始,而縮進的結束則表示此代碼塊的結束。 Python 中實現對代碼的縮進,可以使用空格或者 Tab 鍵實現。但無論是手動敲空格,還是使用 Tab 鍵,通常情況下都是採用 4 個空格長度作為一個縮進量(預設情況下,一個 Tab 鍵就表示 4 個空格)。3.編碼規範
Python 採用 PEP 8 作為編碼規範,下麵列出一些常見的編碼規則: 每個 import 語句只導入一個模塊,儘量避免一次導入多個模塊; 不要在行尾添加分號,也不要用分號將兩條命令放在同一行; 建議每行不超過 80 個字元,如果超過,建議使用小括弧將多行內容隱式的連接起來,而不推薦使用反斜杠進行連接; 使用必要的空行可以增加代碼的可讀性,通常在頂級定義(如函數或類的定義)之間空兩行,而方法定義之間空一行,另外在用於分隔某些功能的位置也可以空一行; 通常情況下,在運算符兩側、函數參數之間以及逗號兩側,都建議使用空格進行分隔。4.標識符命名規範
標識符主要作用就是作為變數、函數、類、模塊以及其他對象的名稱,命名規則如下:- 標識符是由字元(A~Z 和 a~z)、下劃線和數字組成,但第一個字元不能是數字;
- 標識符不能和 Python 中的保留字相同;
- Python中的標識符中,不能包含空格、@、% 以及 $ 等特殊字元;
- 標識符中的字母是嚴格區分大小寫的;
- 以下劃線開頭的標識符有特殊含義:
- Python允許漢字作為標識符,但應避免使用漢字作為標識符;
- 當標識符用作模塊名時,應儘量短小,並且全部使用小寫字母,可以使用下劃線分割多個字母,例如 game_mian;
- 當標識符用作包的名稱時,應儘量短小,也全部使用小寫字母,不推薦使用下劃線,例如 com.mr;
- 當標識符用作類名時,應採用單詞首字母大寫的形式。例如,定義一個圖書類,可以命名為 Book;
- 模塊內部的類名,可以採用 "下劃線+首字母大寫" 的形式,如 _Book;
- 函數名、類中的屬性名和方法名,應全部使用小寫字母,多個單詞之間可以用下劃線分割;
- 常量命名應全部使用大寫字母,單詞之間可以用下劃線分割;
5.python關鍵字
關鍵字是 Python 語言中一些已經被賦予特定意義的單詞,不能用這些保留字作為標識符給變數、函數、類、模板以及其他對象命名。 使用以下命令查看關鍵字:1 import keyword 2 keyword.kwlist