Python注释详解

注释用于说明代码实现的功能、采用的算法、代码的编写者以及创建和修改的时间等信息。

注释是代码的一部分，注释起到了对代码补充说明的作用。

Python注释

Python单行注释以#开头，单行注释可以作为单独的一行放在被注释的代码行之上，也可以放在语句或者表达式之后。

#Give you a chance to let you know me
print("Give you a chance to let you know me")
say_what = "this is a demo" #at the end of a line

Python 中多行注释使用三个单引号(''')或三个双引号("""),而实际上这个是多行字符串的书写方式，并不是Python本身提倡的多行注释。

Python注释参见：https://docs.python.org/3/reference/lexical_analysis.html#comments

# 文件名：test.py
'''
这是多行注释，使用单引号。
这是多行注释，使用单引号。
'''
"""
这是多行注释，使用双引号。
这是多行注释，使用双引号。
"""

Python中还有一些特殊注释以完成一些特别的功能，例如：编码注释、平台注释。

编码注释：

# -*- coding: UTF-8 -*- 
print ("你好，Python");

从Python3开始，Python默认使用UTF-8编码，所以Python3.x的源文件不需要特殊声明UTF-8编码。

参见：https://www.python.org/dev/peps/pep-0008/#source-file-encoding

平台注释：如果需要使Python程序运行在Windows以为的平台上，需要在Python文件的最前面加上如下注释说明。

#!/usr/bin/python

#!/usr/bin/python说明了程序用的环境的路径。

如果使用文本编辑器进行Python程序编辑注释也可以用于程序调试，即将程序分成若干部分注释掉多余代码，把精力集中在当前编写的代码逻辑上。