快捷導(dǎo)航

Python注釋之多行注釋和單行注釋使用及說(shuō)明

更新時(shí)間：2026年04月10日 10:55:11 作者：梁辰興

本文介紹了Python中的注釋類型、使用方法及注意事項(xiàng),注釋有助于提高代碼可讀性、幫助調(diào)試程序,合理使用注釋可以讓代碼更加清晰易懂,建議注釋占比約為三分之一

前言

在編寫 Python 代碼時(shí)，注釋（Comments）是一個(gè)非常重要的元素。它就像是代碼中的小幫手，用來(lái)向用戶提示或解釋某些代碼的作用和功能。注釋可以出現(xiàn)在代碼中的任何位置，而且 Python 解釋器在執(zhí)行代碼時(shí)會(huì)自動(dòng)忽略注釋，就好像它根本不存在一樣，不會(huì)對(duì)代碼的實(shí)際運(yùn)行產(chǎn)生任何影響。

在調(diào)試（Debug）程序的過(guò)程中，注釋還能發(fā)揮特別的作用。有時(shí)候我們可能會(huì)遇到一些暫時(shí)不需要執(zhí)行的代碼，或者覺(jué)得某些代碼可能存在問(wèn)題，這時(shí)候就可以通過(guò)注釋把這些代碼“隱藏”起來(lái)，讓 Python 解釋器不去處理它們。

注釋最大的好處就是能夠提高程序的可讀性。想象一下，如果一段代碼沒(méi)有任何注釋，對(duì)于其他人，甚至是過(guò)了一段時(shí)間后的自己來(lái)說(shuō)，就像一本看不懂的天書，會(huì)讓人感到非常頭疼！所以，千萬(wàn)不要覺(jué)得自己寫的代碼規(guī)范，就可以不加注釋。把沒(méi)有注釋的代碼交給別人，其實(shí)是對(duì)別人的不尊重，是一種很自私的行為哦。很多程序員寧愿自己去開(kāi)發(fā)一個(gè)新的應(yīng)用，也不愿意去修改別人沒(méi)有合理注釋的代碼，這是因?yàn)闆](méi)有注釋的代碼實(shí)在是太難理解了。雖然良好的代碼本身也可以有一定的可讀性，但我們永遠(yuǎn)不知道今后閱讀這段代碼的人是誰(shuí)，他是不是和我們有一樣的思路；而且，時(shí)間久了，我們自己可能也會(huì)忘記當(dāng)時(shí)寫這段代碼的目的。

一般來(lái)說(shuō)，合理的代碼注釋應(yīng)該占到源代碼的三分之一左右，這樣可以讓代碼更加清晰易懂。

Python 支持兩種類型的注釋，分別是單行注釋和多行注釋。

下面我們就來(lái)詳細(xì)了解一下這兩種注釋的使用方法。

Python 單行注釋

在 Python 中，我們使用井號(hào)#作為單行注釋的符號(hào)。

它的語(yǔ)法格式非常簡(jiǎn)單，就是在#后面加上你想要注釋的內(nèi)容，如下所示：

# 注釋內(nèi)容

只要 Python 解釋器遇到#，就會(huì)忽略從#開(kāi)始一直到這行結(jié)束的所有內(nèi)容。也就是說(shuō)，這一行后面的所有文字都不會(huì)被 Python 解釋器執(zhí)行，而是作為注釋存在。

當(dāng)我們要說(shuō)明多行代碼的功能時(shí)，一般會(huì)把注釋放在代碼的上一行。

比如下面這段代碼：

# 使用print輸出字符串
print("Hello World!")
print("C語(yǔ)言中文網(wǎng)")
print("http://c.biancheng.net/python/")
# 使用 print輸出數(shù)字
print(100)
print( 3 + 100 * 2)
print( (3 + 100) * 2 )

在這個(gè)例子中，“# 使用print輸出字符串”這個(gè)注釋就說(shuō)明了下面三行代碼的作用，“# 使用 print輸出數(shù)字”則說(shuō)明了后面三行代碼的作用。

而當(dāng)我們要說(shuō)明單行代碼的功能時(shí)，通常會(huì)把注釋放在代碼的右側(cè)。像這樣：

print("http://c.biancheng.net/python/")  #輸出Python教程的地址
print( 36.7 * 14.5 )  #輸出乘積
print( 100 % 7 )  #輸出余數(shù)

在這些代碼中，右側(cè)的注釋清晰地說(shuō)明了每一行代碼的具體功能。

Python 多行注釋

多行注釋，顧名思義，就是可以一次性注釋程序中多行的內(nèi)容，當(dāng)然也包括只注釋一行的情況。

在 Python 中，我們使用三個(gè)連續(xù)的單引號(hào)’''或者三個(gè)連續(xù)的雙引號(hào)"""來(lái)注釋多行內(nèi)容。

具體格式如下：

'''
使用 3 個(gè)單引號(hào)分別作為注釋的開(kāi)頭和結(jié)尾
可以一次性注釋多行內(nèi)容
這里面的內(nèi)容全部是注釋內(nèi)容
'''

或者

"""
使用 3 個(gè)雙引號(hào)分別作為注釋的開(kāi)頭和結(jié)尾
可以一次性注釋多行內(nèi)容
這里面的內(nèi)容全部是注釋內(nèi)容
"""

多行注釋通常會(huì)被用來(lái)為 Python 文件、模塊、類或者函數(shù)等添加版權(quán)或者功能描述信息。比如說(shuō)，我們寫了一個(gè)函數(shù)，就可以在函數(shù)的開(kāi)頭使用多行注釋來(lái)描述這個(gè)函數(shù)的作用、輸入?yún)?shù)和返回值等信息，這樣其他人在使用這個(gè)函數(shù)的時(shí)候就能很清楚地知道它的功能了。

注意事項(xiàng)

Python多行注釋是不支持嵌套的哦

也就是說(shuō)，下面這樣的寫法是錯(cuò)誤的：

'''
外層注釋
    '''
    內(nèi)層注釋
    '''
'''

因?yàn)?Python 解釋器沒(méi)辦法正確識(shí)別這種嵌套的注釋結(jié)構(gòu)，可能會(huì)導(dǎo)致代碼出現(xiàn)錯(cuò)誤。

不管是多行注釋還是單行注釋

當(dāng)注釋符作為字符串的一部分出現(xiàn)時(shí)，就不能再把它們視為注釋標(biāo)記了，而應(yīng)該把它們看作正常代碼的一部分。

比如下面這段代碼：

print('''Hello,World!''')
print("""http://c.biancheng.net/cplus/""")
print("#是單行注釋的開(kāi)始")

運(yùn)行這段代碼后，我們會(huì)得到以下結(jié)果：

Hello,World!
http://c.biancheng.net/cplus/
#是單行注釋的開(kāi)始

對(duì)于前兩行代碼，Python 沒(méi)有把這里的三個(gè)引號(hào)看作是多行注釋，而是把它們當(dāng)成了字符串的開(kāi)始和結(jié)束標(biāo)志。對(duì)于第 3 行代碼，Python 也沒(méi)有把井號(hào)看作單行注釋，而是把它當(dāng)成了字符串的一部分。所以，我們?cè)趯懘a的時(shí)候一定要注意這一點(diǎn)，避免因?yàn)榛煜鴮?dǎo)致錯(cuò)誤。

注釋可以幫助調(diào)試程序

給代碼添加說(shuō)明是注釋最基本的作用，除此之外，它還有一個(gè)非常實(shí)用的功能，那就是用來(lái)調(diào)試程序。

比如說(shuō)，當(dāng)我們?cè)诰帉懗绦虻臅r(shí)候，發(fā)現(xiàn)程序運(yùn)行結(jié)果不對(duì)，懷疑某段代碼可能有問(wèn)題。這時(shí)候，我們可以先把這段代碼注釋起來(lái)，也就是用注釋符號(hào)把它變成注釋內(nèi)容，讓 Python 解釋器忽略這段代碼，然后再運(yùn)行程序。如果程序可以正常執(zhí)行了，那就說(shuō)明錯(cuò)誤很可能就是由這段被注釋的代碼引起的；反之，如果程序依然出現(xiàn)相同的錯(cuò)誤，那就說(shuō)明錯(cuò)誤不是由這段代碼引起的，我們就需要繼續(xù)檢查其他代碼。

通過(guò)在調(diào)試程序的過(guò)程中使用注釋，我們可以逐步縮小錯(cuò)誤所在的范圍，快速找到問(wèn)題的根源，大大提高調(diào)試程序的效率。所以，在編程過(guò)程中，合理使用注釋不僅能讓代碼更易讀，還能幫助我們更快地解決問(wèn)題哦。