Python数据科学应用从入门到精通
上QQ阅读APP看书,第一时间看更新

2.3 Python的注释

接下来介绍Python语言的一系列规则,内容可能会略显枯燥,但这是实现“读懂别人编写的代码—根据实际需求对已有代码进行调参—实现自主编写代码”层层进阶的必备基础,需要下功夫练好这一基本功。本节讲解最为常用的注释。

在Python中,注释是对代码的解释,以增加代码的可读性,让将来的自己、合作人员或将来的程序维护人员能够更好地理解这些代码的含义。在代码行的后面加上“#”符号,后续文字即为注释。比如以下代码:

其中data.describe()为要执行的代码,而“#”及后面的内容则为对data.describe()这一执行代码的注释。注释的作用仅在于告知阅读该代码的人该段代码的具体含义或其他相关信息,因此“#”及后面的内容将被Python解释器忽略掉,不会被执行。注释可以放在代码的后面,也可以放到代码前面作为单独的一行。上述代码及注释也可写为:

注释可以为一行,也可以为多行。需要注意的是,如果为多行,就需要在每一行的行首都加上“#”。上述代码及注释也可写为: