掃二維碼與項目經(jīng)理溝通
我們在微信上24小時期待你的聲音
解答本文疑問/技術(shù)咨詢/運營咨詢/技術(shù)建議/互聯(lián)網(wǎng)交流
關(guān)于編程語言中的注釋,其重要性基本上已為大家所共識。

色尼ssl適用于網(wǎng)站、小程序/APP、API接口等需要進行數(shù)據(jù)傳輸應用場景,ssl證書未來市場廣闊!成為創(chuàng)新互聯(lián)的ssl證書銷售渠道,可以享受市場價格4-6折優(yōu)惠!如果有意向歡迎電話聯(lián)系或者加微信:18982081108(備注:SSL證書合作)期待與您的合作!
然而關(guān)于注釋的規(guī)范,這個話題就像我們之前聊過的縮進、終止符和命名方式一樣,眾口難調(diào)。
注釋符通常可分為兩種,即行注釋與塊注釋(inline/block),它們在不同的編程語言中的符號可謂讓人眼花繚亂。
比如行注釋符,它至少有以下的 17 種之多(出自維基百科):
其中兩個最大的陣營分別是“//”與“#”號:
那么,**Python 為什么用“#”號作注釋符,而不是“//”呢? **
這個問題恐怕沒辦法從解析的效率、符號的辨識度和輸入的便利性等方面回答,因為它們基本上沒有區(qū)別。
我沒有找到官方的解釋,但是從這些注釋符的陣營中,已經(jīng)不難得出一個較為合理的解釋:
Python 在創(chuàng)造之初,從 C 和 Shell 語言中借鑒了不少東西,但它是一種腳本語言,因此在注釋符這個最為基礎(chǔ)的語言要素上,就偏向了腳本語言的傳統(tǒng)。
在某些“類腳本語言”中,比如 yaml、conf 和 ini 等格式的配置文件,它們大多也是采用腳本語言的“#”號作為注釋符。
所以,Python 行內(nèi)注釋符的選擇,大概可以歸結(jié)為一種歷史原因,即借鑒了 Shell 腳本語言的寫法。
相比于行注釋符的多樣,塊注釋符更加是讓人眼花繚亂:
大多數(shù)寫法是我從未見過的,有些甚至是難以忍受的,槽點太多!
在這份表格里,我們看不到 Python,因為從嚴格意義上講,Python 并沒有塊注釋符!
一般而言,我們在連續(xù)的每行內(nèi)容前面加“#”號,達到塊注釋的效果。塊注釋被看作是多個行注釋。
PEP-8 中是這么建議的:
有人曾在 Twitter 上發(fā)問,為什么 Python 沒有塊注釋符?
Guido 回復稱,可以將多行字符串用作塊注釋:
Python 的多行字符串用三對單引號或雙引號表示,它還可以用作文檔字符串(即Documentation Strings,簡寫docstrings)。
但是,將它當做多行注釋符使用,在語義上則有點怪怪的——它表示的是一段字符串,雖然沒有賦值給變量,不會生成代碼,但是它并非語義上的注釋。
由于腳本語言的特性,它允許我們寫一段“無根的字符串”,在語法上沒有問題,也沒有負作用(negative effects),但是,如果把它作為注釋使用,這就是一種副作用(side effects)了。
從這點上考慮,我雖然不反對有人把多行字符串寫法用作塊注釋,但是我會更推薦大家使用“#”號作注釋。
另外,對于無用的代碼,最好的做法就是直接刪除,如果后續(xù)發(fā)現(xiàn)有需要,再回退修改。詳細的多行注釋盡量放在文檔字符串中,這樣在核心代碼中就會很少出現(xiàn)多行注釋的情況了。
對于 Python 的注釋符用法,大家是怎么想的呢?歡迎留言交流。

我們在微信上24小時期待你的聲音
解答本文疑問/技術(shù)咨詢/運營咨詢/技術(shù)建議/互聯(lián)網(wǎng)交流