小編給大家分享一下Python代碼注釋規(guī)范代碼的案例分析，希望大家閱讀完這篇文章后大所收獲，下面讓我們一起去探討吧！

創(chuàng)新互聯(lián)公司，是成都地區(qū)的互聯(lián)網(wǎng)解決方案提供商，用心服務(wù)為企業(yè)提供網(wǎng)站建設(shè)、重慶App定制開(kāi)發(fā)、成都小程序開(kāi)發(fā)、系統(tǒng)按需開(kāi)發(fā)和微信代運(yùn)營(yíng)服務(wù)。經(jīng)過(guò)數(shù)10年的沉淀與積累，沉淀的是技術(shù)和服務(wù)，讓客戶少走彎路，踏實(shí)做事，誠(chéng)實(shí)做人，用情服務(wù)，致力做一個(gè)負(fù)責(zé)任、受尊敬的企業(yè)。對(duì)客戶負(fù)責(zé)，就是對(duì)自己負(fù)責(zé)，對(duì)企業(yè)負(fù)責(zé)。

一、代碼注釋介紹

• 注釋就是對(duì)代碼的解釋和說(shuō)明，其目的是讓人們能夠更加輕松地了解代碼。
• 注釋是編寫(xiě)程序時(shí)，寫(xiě)程序的人給一個(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)表示多行注釋。用在注釋多寫(xiě)不下的情況，如下例子：

'''
這是使用三個(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ù)中的文檔字符串屬性。

編寫(xiě)示例如下：

def add(num1,num2):
  """ 完成傳入的兩個(gè)數(shù)之和

  :param num1: 加數(shù)1
  :param num2: 加數(shù)2
  :return: 和
  """
  return num1 + num2

print( add.__doc__ )

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

五、DocStrings常用編寫(xiě)風(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 param

Returns:
 This is a description of what is returned

Raises:
 KeyError - raises an exception
"""

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

"""
My numpydoc description of a kind
of very exhautive numpydoc format docstring.

Parameters
----------
first : array_like
 the 1st param name `first`
second :
 the 2nd param
third : {'value', 'other'}, optional
 the 3rd param, by default 'value'

Returns
-------
string
 a value in a string

Raises
------
KeyError
 when a key error
OtherError
 when an other error
"""

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

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

看完了這篇文章，相信你對(duì)Python代碼注釋規(guī)范代碼的案例分析有了一定的了解，想了解更多相關(guān)知識(shí)，歡迎關(guān)注創(chuàng)新互聯(lián)-成都網(wǎng)站建設(shè)公司行業(yè)資訊頻道，感謝各位的閱讀！

本文標(biāo)題：Python代碼注釋規(guī)范代碼的案例分析-創(chuàng)新互聯(lián)
文章網(wǎng)址：http://sd-ha.com/article36/dghcpg.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供營(yíng)銷型網(wǎng)站建設(shè)、網(wǎng)站改版、App開(kāi)發(fā)、響應(yīng)式網(wǎng)站、品牌網(wǎng)站建設(shè)、做網(wǎng)站

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請(qǐng)盡快告知，我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng)，如需處理請(qǐng)聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時(shí)需注明來(lái)源： 創(chuàng)新互聯(lián)