2.2 注釋

在計(jì)算機(jī)語(yǔ)言中，注釋用于解釋說(shuō)明某段代碼的作用，便于軟件程序后期的維護(hù)和調(diào)試工作。注釋并不會(huì)增加可執(zhí)行程序的大小，在執(zhí)行程序時(shí)會(huì)忽略所有注釋。在本節(jié)中，將詳細(xì)講解Python語(yǔ)言注釋的基本知識(shí)。

在Python程序中有2種類型的注釋，分別是單行注釋和多行注釋。

（1）單行注釋

單行注釋是指只在一行中顯示注釋內(nèi)容，Python中單行注釋以#開(kāi)頭，具體語(yǔ)法格式如下。

例如下面的代碼。

（2）多行注釋

多行注釋也被稱為成對(duì)注釋，是從C語(yǔ)言繼承過(guò)來(lái)的，這類注釋的標(biāo)記符號(hào)是成對(duì)出現(xiàn)的。在Python程序中，有兩種實(shí)現(xiàn)多行注釋的方法。

● 第一種：用三個(gè)單引號(hào)“'''”將注釋括起來(lái)。

● 第二種：用三個(gè)雙引號(hào)“"""”將注釋括起來(lái)。

例如下面是用三個(gè)單引號(hào)創(chuàng)建的多行注釋。

例如下面是用三個(gè)雙引號(hào)創(chuàng)建的多行注釋。

在Python程序中通常混用上述2種注釋形式。注釋太多的程序代碼容易導(dǎo)致代碼難以理解，通常較好的處理方式是將一個(gè)注釋塊放在所解釋代碼的上方。當(dāng)改變代碼時(shí)，注釋應(yīng)與代碼保持一致。程序員即使知道系統(tǒng)其他形式的文檔已經(jīng)過(guò)期，但還是會(huì)比較相信注釋，認(rèn)為它會(huì)是正確的解釋。所以錯(cuò)誤的注釋比沒(méi)有注釋更糟，因?yàn)樗鼤?huì)誤導(dǎo)后來(lái)者。

實(shí)例文件zhushi.py的具體實(shí)現(xiàn)代碼如下所示。

在上述代碼中，雖然前2個(gè)print語(yǔ)句是Python格式的代碼，但是因?yàn)樵谧⑨寴?biāo)記符號(hào)內(nèi)，所以執(zhí)行后不會(huì)顯示任何效果。執(zhí)行后會(huì)輸出如下的效果。