Python基礎(chǔ)之注釋的用法

更新時(shí)間：2021年06月25日 08:58:14 作者：繁花似錦Fighting

今天給大家?guī)?lái)的是關(guān)于Python的相關(guān)知識(shí),文章圍繞著Python注釋的用法展開(kāi),文中有非常詳細(xì)的介紹及代碼示例,需要的朋友可以參考下

前言

Python代碼的基本規(guī)范如下：

1、Python 文件將以 .py 為擴(kuò)展名。

2、在Python中嚴(yán)格區(qū)分大小寫（大小寫敏感），如果寫錯(cuò)了大小寫，程序會(huì)報(bào)錯(cuò)。

3、Python中的每一行就是一條語(yǔ)句，每條語(yǔ)句以換行結(jié)束，不用;分號(hào)結(jié)束。

4、Python是縮進(jìn)嚴(yán)格的語(yǔ)言，所以在Python中不要隨便寫縮進(jìn)。

縮進(jìn)的好處是強(qiáng)迫你寫出縮進(jìn)較少的代碼，你會(huì)傾向于把一段很長(zhǎng)的代碼拆分成若干函數(shù)，從而得到縮進(jìn)較少的代碼。
縮進(jìn)的壞處就是復(fù)制－粘貼功能失效了，當(dāng)你重構(gòu)代碼時(shí)，粘貼過(guò)去的代碼必須重新檢查縮進(jìn)是否正確。

5、一條語(yǔ)句可以分多行編寫，多行編寫時(shí)語(yǔ)句后邊以\結(jié)尾。

6、Python中每一行語(yǔ)句不要過(guò)長(zhǎng)（規(guī)范中建議每行不要超過(guò)80個(gè)字符）。

擴(kuò)展：

Python中文文檔地址：https://docs.python.org/zh-cn/3/index.html。關(guān)于代碼規(guī)范：
Python 官方提供有一系列 PEP（Python Enhancement Proposals）文檔，其中第 8 篇文檔專門針對(duì) Python 的代碼格式給出了建議，也就是俗稱的 PEP 8。
文檔地址：https://www.python.org/dev/peps/pep-0008/。

一、注釋的作用

通過(guò)使用自己熟悉的語(yǔ)言，在程序中提示或解釋某些關(guān)鍵代碼的思路、作用和功能等，能夠大大增強(qiáng)程序的可讀性。（代碼的可讀性是非常重要的）

代碼注釋效果如下圖：

沒(méi)有添加注釋的代碼。

添加注釋的代碼。

二、注釋的分類

注釋分為兩類：?jiǎn)涡凶⑨?和多行注釋。

單行注釋

#作為單行注釋的符號(hào)。只注釋一行內(nèi)容，語(yǔ)法如下：

# 注釋內(nèi)容

多行注釋

可以注釋多行內(nèi)容，常用來(lái)為 Python 函數(shù)、類、模塊等等添加功能、版本和作者等描述信息，語(yǔ)法如下：

#寫法一：一對(duì)三雙引號(hào)
"""
  第一行注釋
  第二行注釋
  第三行注釋
"""

#寫法二：一對(duì)三單引號(hào)
'''
  注釋1
  注釋2
  注釋3
'''

三、注釋的注意事項(xiàng)

Python 解釋器（Python Interpreter）在執(zhí)行程序（代碼）時(shí)會(huì)忽略注釋部分，不做任何處理。
當(dāng)Python解釋器解析Python文件的時(shí)候，一旦發(fā)現(xiàn)出現(xiàn)了#，就會(huì)認(rèn)為#右邊的文字全部都是說(shuō)明性的文字，Python的解釋器會(huì)直接跳過(guò)這一行，解釋下一行代碼。

極簡(jiǎn)單的注釋可以放到一行代碼的后面，一般習(xí)慣代碼后面添加兩個(gè)空格，再書寫注釋文字。

print('hello Python')  # 輸出

#號(hào)和注釋之間需要加上一個(gè)空格，不是強(qiáng)制，是規(guī)范。

Python 多行注釋不支持嵌套，如下所示為錯(cuò)誤寫法：

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

多行注釋符號(hào)'''或"""也可以作為字符串的開(kāi)始和結(jié)束標(biāo)記。
Python 中當(dāng)多行注釋符號(hào)作為字符串的一部分出現(xiàn)時(shí)，就不能再將它們當(dāng)做多行注釋標(biāo)記，而應(yīng)該看做是字符串的一部分，如下所示：

#方式一
print("hello world ! hello python !")
print('hello world !')
print("""真香""")
print('''是真的''')

#方式二
str1 = "hello world ! hello python !"
str2 = 'hello world !'
str3 = """真香"""
str4 = '''是真的'''
print(str1)
print(str2)
print(str3)
print(str4)

"""
#執(zhí)行結(jié)果都是
hello world ! hello python !
hello world ! 
真香
是真的
"""