一、代碼注釋介紹

注釋就是對(duì)代碼的解釋和說(shuō)明，其目的是讓人們能夠更加輕松地了解代碼。 注釋是編寫程序時(shí)，寫程序的人給一個(gè)語(yǔ)句、程序段、函數(shù)等的解釋或提示，能提高程序代碼的可讀性。 在有處理邏輯的代碼中，源程序有效注釋量必須在20％以上。

二、代碼注釋分類

行注釋：在符號(hào)后那一行不會(huì)被編譯（顯示）

塊注釋：被塊注釋符號(hào)中間的部分不會(huì)被編譯

三、python代碼注釋基礎(chǔ)

Python中使用#表示單行注釋。單行注釋可以作為單獨(dú)的一行放在被注釋代碼行之上，也可以放在語(yǔ)句或表達(dá)式之后。如下例子：

name = ’xiaohong’ # 單行注釋

# 單行注釋name = ’xiaohong’

Python中使用三個(gè)單引號(hào)或三個(gè)雙引號(hào)表示多行注釋。用在注釋多寫不下的情況，如下例子：

’’’這是使用三個(gè)單引號(hào)的多行注釋’’’

'''這是使用三個(gè)雙引號(hào)的多行注釋'''

四、DocStrings介紹與使用

4.1 DocStrings介紹

文檔字符串

是一個(gè)重要工具，用于解釋文檔程序，幫助你的程序文檔更加簡(jiǎn)單易懂

4.2 python中使用DocStrings

在函數(shù)體的第一行使用一對(duì)三個(gè)單引號(hào) ’’’ 或者一對(duì)三個(gè)雙引號(hào) ''' 來(lái)定義文檔字符串。你可以使用 doc（注意雙下劃線）調(diào)用函數(shù)中的文檔字符串屬性。

編寫示例如下：

def add(num1,num2): ''' 完成傳入的兩個(gè)數(shù)之和 :param num1: 加數(shù)1 :param num2: 加數(shù)2 :return: 和 ''' return num1 + num2print( add.__doc__ )

備注：DocStrings 文檔字符串使用慣例：它的首行簡(jiǎn)述函數(shù)功能，第二行空行，第三行為函數(shù)的具體描述。

五、DocStrings常用編寫風(fēng)格

5.1 reST風(fēng)格

這是現(xiàn)在流行的一種風(fēng)格，reST風(fēng)格，Sphinx的御用格式，比較緊湊。

'''This is a reST style.:param param1: this is a first param:param param2: this is a second param:returns: this is a description of what is returned:raises keyError: raises an exception'''

5.2 Google風(fēng)格

'''This is a groups style docs.Parameters: param1 - this is the first param param2 - this is a second paramReturns: This is a description of what is returnedRaises: KeyError - raises an exception'''

5.3 Numpydoc (Numpy風(fēng)格)

'''My numpydoc description of a kindof very exhautive numpydoc format docstring.Parameters----------first : array_like the 1st param name `first`second : the 2nd paramthird : {’value’, ’other’}, optional the 3rd param, by default ’value’Returns-------string a value in a stringRaises------KeyError when a key errorOtherError when an other error'''

六、一些注釋經(jīng)驗(yàn)

注釋不是越多越好。對(duì)于一目了然的代碼，不需要添加注釋。 對(duì)于復(fù)雜的操作，應(yīng)該在操作開(kāi)始前寫上相應(yīng)的注釋。 對(duì)于不是一目了然的代碼，應(yīng)該在代碼之后添加注釋。 絕對(duì)不要描述代碼。一般閱讀代碼的人都了解Python的語(yǔ)法，只是不知道代碼要干什么

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持好吧啦網(wǎng)。