注释是给你看的,而不是让计算机执行的。注释是程序文档的一部分,计算机运行程序时会忽略这些注释。
Python 中向程序增加注释有两种方法。
术语箱
文档(documentation)就是关于一个程序的信息,描述了程序并说明它是如何工作的。注释是程序文档的一部分,不过在代码本身以外,文档还包括其他部分,文档描述以下内容:
为什么写这个程序(它的用途)
这个程序是谁写的
这个程序面向什么人(它的用户)
如何组织
更大、更复杂的程序往往有更多文档。
第 6 章中提到的 Python 帮助就是一种文档。它的作用是帮助用户了解 Python 如何工作。