2.7 注釋

隨著程序變得越寫越長，越來越復雜，它們的可讀性也越來越差。形式語言是稠密的， 通常很難在讀一段代碼后，說出其做什么或者為什么這樣做。

1string concatenation , # compute the percentage of the hour that has elapsed # 計算逝去的時間占一小時的比例 percentage = ( minute * 100) / 60 ,p ercentage = ( minute * 100) / 60 # percentage of an hour ,v = 5 # assign 5 to v ,v = 5 # velocity in meters / second .

16 第二章 變量、表達式和語句

因此，在你的程序中需要用自然語言做些筆記，解釋程序將做些什么。這些筆記被稱為

注釋 (comments)，以 # 符號開始。

r

此例中，注釋獨占一行。你也可以將注釋放在行尾：

r

從# 開始到行尾的所有內容都會被解釋器忽略—其內容對程序執行不會有任何影響。

在注釋中記錄代碼不明顯的特征，是最有幫助的。假設讀者能夠讀懂代碼做了什么是合 理的；但是解釋代碼為什么這么做則更有用。

下面這個注釋只是重復了代碼，沒有什么用：

r

下面的注釋包括了代碼中沒有的有用信息：

r

好的變量名能夠減少對注釋的需求，但是長變量名使得表達式很難讀，因此這里有個平 衡問題。

總結

以上是生活随笔為你收集整理的[云炬ThinkPython阅读笔记]2.7 注释的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。