「Python编程规范」为Python代码添加注释

功能要求

为Python代码添加注释，对Python程序代码进行说明。

实例代码

'''多行注释开始

下面的代码根据变量x的值计算y

注意代码中使用缩进表示代码块

多行注释结束'''

x = 5

if x >100:

y = x * 5 - 1 # 单行注释：x>100时执行该语句

else:

y = 0 # x <= 100时执行该语句

print(y) # 输出y

运行结果

知识说明

注释用于为程序添加说明性的文字，帮助程序员更好的阅读和理解程序代码。Python解释器会忽略注释的内容，即注释的内容不会被Python解释器执行。

Python注释分为单行注释和多行注释。

单行注释以符号“#”开始，当前行中符号“#”及其后的内容为注释语句。单行注释可以独占一行，也可放在语句末尾。 说明： 在Pycharm中使用“ctrl + /”可以添加/取消单行注释。

多行注释是用3个英文单引号“'''多行注释文本'''”或3个双引号“"""注释文本"""”进行注释。 注意： 由一对三个单引号或一对三个双引号括起来的内容被认为是注释，但不能由三个单引号和三个双引号混合使用。

1、先选中要注释的段落，然后按下“CTRL+/”，即可实现多行代码的注释；

2、跟注释单行一样在每一行代码前输入“SHIFT+#”或者按下“CTRL+/”；

3、输入（'''内容'''）单引号或者（"""内容"""）双引号，也可以实现注释多行代码的效果。

推荐第1种，注释和取消比较方便，但是颜色是灰色的不是绿色的。

python中的注释有单行注释和多行注释：

1、单行注释(行注释)

python中使用#表示单行注释。单行注释可以作为单独的一行放在被注释代码行之上，也可以放在语句或表达式之后。

比如：

# 这是一个注释

print("Hello, World!")

①当单行注释作为单独的一行放在被注释代码行之上时，为了保证代码的可读性，建议在#后面添加一个空格，再添加注释内容。

②当单行注释放在语句或者表达式之后时，同样为了保证代码的可读性，建议注释和语句之间至少要有两个空格。

2、多行注释(块注释)

当注释内容过多，导致一行无法显示时，就可以使用多行注释。多行注释用三个单引号'''或者三个双引号 """将注释括起来。

①单引号(''')

'''

这是多行注释，用三个单引号

这是多行注释，用三个单引号

这是多行注释，用三个单引号

'''

print("Hello, World!")

②双引号(""")

"""

这是多行注释，用三个双引号

这是多行注释，用三个双引号

这是多行注释，用三个双引号

"""

print("Hello, World!")

3、注意

①注释不是越多越好，对于一目了然的代码，不需要添加注释

②对于复杂的 *** 作，应该在 *** 作开始前写上相应的注释

③对于不是一目了然的代码，可以在代码之后添加注释

④绝对不要描述代码，一般阅读代码的人都了解python的语法，只是不知道代码要干什么。

---