Python中什么情況下需要使用注釋？

在注釋代碼的時候我們應當注意：

1. 注釋不是越多越好，對于一目了然的代碼，不需要添加注釋
   

2. 對于 復雜的操作，應該在操作開始前寫上若干行注釋
   

3. 對于 不是一目了然的代碼，應在其行尾添加注釋（為了提高可讀性，注釋應該至少離開代碼 2 個空格）
   

4. 絕不要描述代碼，假設閱讀代碼的人比你更懂 Python，他只是不知道你的代碼要做什么
   

   
   

在一些正規(guī)的開發(fā)團隊，通常會有代碼審核的慣例，就是一個團隊中彼此閱讀對方的代碼，找出和發(fā)現在開發(fā)中出現的錯誤并及時訂正，預防代碼出現錯誤，提高代碼的安全性。減少后期的軟件檢查。而注釋代碼就是為了給同事或者同行提供便利，以求更快的理解你寫這行代碼的意思，知道你要做什么。
 

關于代碼規(guī)范

Python 官方提供有一系列 PEP（Python Enhancement Proposals） 文檔

其中第 8 篇文檔專門針對 Python 的代碼格式 給出了建議，也就是俗稱的 PEP 8

文檔地址：https://www.python.org/dev/peps/pep-0008/

谷歌有對應的中文文檔：http://zh-google-styleguide.readthedocs.io/en/latest/google-python-styleguide/python_style_rules/

什么是注釋？Java中的注釋都有哪幾種？

黑馬程序員Java培訓