首页 » 父与子的编程之旅:与小卡特一起学Python » 父与子的编程之旅:与小卡特一起学Python全文在线阅读

《父与子的编程之旅:与小卡特一起学Python》9.4 多行注释

关灯直达底部

有时你可能想使用多行注释。可以使用多行,每行前面都有一个 # 字符,像下面这样:

# ***************# 这个程序用来说明Python 中如何使用注释# 星号所在的行只为将注释# 与其余代码清楚地区分开# ***************  

多行注释可以很好地“突出”代码段,使你读代码时能清楚地区分不同代码段。可以用多行注释来描述一段代码要做什么。程序最开始的多行注释可以列出作者的名字、程序名、编写或更新的日期,以及你认为可能有用的任何其他信息。

三重引号字符串

Python 中还有一种方法可以相当于多行注释。只需建立一个没有名字的三重引号字符串。还记得在第 2 章中曾经说过,三重引号字符串是一个可以跨多行的字符串。所以可以这样写:

""" 这是一个包括多行的注释,使用了三重引号字符串。这不完全是注释,不过也可以相当于注释。"""  

因为这个字符串没有名字,而且程序对这个字符串不“做”任何处理,所以它对程序的运行没有任何影响。它相当于一个注释,尽管从严格的 Python 术语来讲这并不是一个真正的注释。

像(Python)程序员一样思考

有些 Python 程序员认为不应该使用三重引号字符串(多行字符串)作为注释。就我个人来说,我看不出这有什么充分的理由。加注释的目的就是让你的代码更易读、更容易理解。如果你觉得三重引号字符串很方便,可能会更愿意在代码中加入注释,这毕竟是件好事。

如果在 IDLE 编辑器键入一些注释,可以看到注释会用不同的颜色显示。这是为了帮助你更容易地读代码。

大多数代码编辑器允许你改变注释的颜色(或者可以改变代码其他部分的颜色)。IDLE 中注释的默认颜色是红色。因为三重引号字符串不是真正的 Python 注释,它们的颜色会不同。在 IDLE 中三重引号字符串是绿色,因为绿色是 IDLE 中字符串的默认颜色。