Python程序注释写在什么位置?Python在代码什么位置添加多行注释

python程序中有些代码是需要添加注释来解释它的构造和功能的,而一些初学python的小伙伴对于注释该写在什么位置就不是很了解了 。所以本文会来给大家介绍一下python中注释的四种添加位置,想要学习这个知识的话就一起往下看看 。

Python程序注释写在什么位置?Python在代码什么位置添加多行注释

文章插图
一、顶部
顶部注释又被称之为文件头注释,它只能够写在一个python脚本文件内代码编写的最顶部,并且对于注释内容有严格要求 。这些注释都是添加#符号的单行注释,内容为解释器路径、编码格式以及版本和开发者信息等等,示例如下:
#!/usr/bin/env python# -*-coding:utf-8 -*-#@Author:Schiller Xu#@Version:1.0二、代码尾部
当行注释可以写在代码的尾部,并且只有单行注释能够写在这个位置,处于该位置的代码注释一般是用来描述这行代码的作用以及运行之后会产生的结果 。写注释时需要使用四个空格,也就是一个缩进的距离将其和代码隔开,示例如下:
print(’输出’)    # 尾部注释三、代码上方
而单行注释和多行注释都是可以写在代码上方的,代码上方的注释一般是用来解释该行代码的结构,例如说此代码是定义变量之类的,示例如下:
【Python程序注释写在什么位置?Python在代码什么位置添加多行注释】# 注释一a = 10’’’注释二’’’a = 33四、函数内部
还有另外一种比较特殊的注释是需要写在函数内部第一行代码处的,因为它会被解析函数文档,而这个函数文档的作用就是去描述函数参数是什么类型有什么用,以及该函数的功能和结果是什么,代码示例如下所示:
def average(a, b, c):    """    该函数用于计算三个数的平均值,并返回一个结果    :param a: int_第一个数    :param b: int_第二个数    :param c: int_第三个数    :return: 返回一个计算结果    """    d = (a + b + c) // 3    print("平均数为:", d)    return d以上就是关于“Python程序注释写在什么位置?Python在代码什么位置添加多行注释”的全部内容了,希望对你有所帮助 。

    推荐阅读