python函数注解,PYTHON注释

如何对python代码进行注释

1、Python 中单行注释以 # 开头

例如：

# 这是个注释

print("Hello, World!")

或者：

print("Hello, World!") # 这是个注释，放在一行的最后

2、多行注释用三个单引号 ''' 或者三个双引号 """ 将注释括起来

例如：

'''

这是多行注释

这是多行注释

'''

print("Hello, World!")

或者：

"""

这是多行注释

这是多行注释

"""

相关问答

Q1: Python 语句和注释

我们将在本节中介绍 Python 语句，缩进以及注释，在本节的最后一部分，还会介绍作为一种特殊类型的 Python 注释 Docstring 。

Python 语句是给解释器执行的指令，一条 Python 语句包含类似于如下的表达式，

你可以将 Python 语句堪称解释器解释表达式并将其结果存储在变量中的指令。类似于 for , while , print 之类的语句具有特殊的含义，我们将在在后面的章节中讨论。

当你在一句语句结束时按回车键后，该 Python 语句被终止，我们可称之为单行语句。Python 中的多行语句可以通过使用连续字符 来创建，它将 Python 语句扩展为多行语句。

比如下面的例子，

这可以被称作明确的多行接续。

你还可以使用括号 () ，方括号 [] 或大括号 {} 来进行隐式的多行接续。

例如，你可以使用括号来连接多行语句，

Python 语句块，例如函数，循环或类的主体，以缩进来开头。对于语句块内的每个语句，应该保持相同的缩进。当缩进不一致时，你将得到什么什么 IndentationError 。

一般来说，在

Python 代码样式指南

中建议使用 4 个缩进空格。举例如下，

我们用缩进来增加程序的可读性，比如在下面的程序中，我们用两种方式来完成同一个功能，

你可以在这里看到第一个例子比第二个例子有更好的可读性。

注释用于描述程序的目的或工作工程，注释是在 Python 解释过程中被忽略的行为，它们不会干扰程序的流程。

如果你正在编写数百行代码，肯定需要添加注释，因为其他人在阅读你的代码的时候，没有足够的时间阅读每一行来理解代码的工作。程序的注释增加了可读性，并解释了代码的工作原理。

Python 注释以井号 # 开始

Using hash symbol in each line can define a multi-line comment. But there is another way to add a multi-line comment in Python, that is using triple quotation marks. You can use either ''' or """ .

三重引号 ''' 通常可以用来定义多行文档注释 Docstring ，你也可以用它来作为另外一种在 Python 中添加多行注释的方法。

Docstring 是文档字符串，它通常是 Python 函数，类，模块等的第一条语句。函数，方法和类的描述和注释位于文档字符串（文档字符串）内。

举例如下，

一目了然， Docstring 介绍了函数的功能。

Q2: Python有哪几种注释方式

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

1、单行注释(行注释)

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

比如：

# 这是一个注释

print("Hello, World!")

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

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

2、多行注释(块注释)

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

①单引号(''')

'''

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

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

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

'''

print("Hello, World!")

②双引号(""")

"""

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

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

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

"""

print("Hello, World!")

3、注意

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

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

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

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

Q3: python中函数定义

1、函数定义

①使用def关键字定义函数

②

def 函数名(参数1.参数2.参数3...):

"""文档字符串，docstring，用来说明函数的作用"""

#函数体

return 表达式

注释的作用：说明函数是做什么的，函数有什么功能。

③遇到冒号要缩进，冒号后面所有的缩进的代码块构成了函数体，描述了函数是做什么的，即函数的功能是什么。Python函数的本质与数学中的函数的本质是一致的。

2、函数调用

①函数必须先定义，才能调用，否则会报错。

②无参数时函数的调用：函数名()，有参数时函数的调用：函数名(参数1.参数2.……)

③不要在定义函数的时候在函数体里面调用本身，否则会出不来，陷入循环调用。

④函数需要调用函数体才会被执行，单纯的只是定义函数是不会被执行的。

⑤Debug工具中Step into进入到调用的函数里，Step Into My Code进入到调用的模块里函数。

Q4: python代码的注释有几种

python代码的注释有两种。

一、python单行注释符号(#)

python中单行注释采用#开头，示例：#thisisacomment。

二、批量、多行注释符号

多行注释是用三引号，例如：输入''''''或者""""，将要注释的代码插在中间。

Python由荷兰数学和计算机科学研究学会的吉多·范罗苏姆于1990年代初设计，作为一门叫做ABC语言的替代品。Python提供了高效的高级数据结构，还能简单有效地面向对象编程。

Python语法和动态类型，以及解释型语言的本质，使它成为多数平台上写脚本和快速开发应用的编程语言，随着版本的不断更新和语言新功能的添加，逐渐被用于独立的、大型项目的开发。"

Q5: python三种注释方法

python三种注释方法：

方式1：

单行注释：shift + #（在代码的最前面输入，非选中代码进行注释）。

多行注释：同单行一样在每一行的前面输入shift + #。

相关推荐：《Python视频教程》。

方式2：

单行和多行一样的方式：Ctr+ /（前提是选中需要注释的代码）。

方式3：

输入＇＇' '''或者＂＂" """，将要注释的代码插在中间。

Python注释好处：

增强代码的可读性。由于个人编码的习惯不同，可能我们自己写的代码不是所有人都能读懂。但是这在团队合作的项目里又是必须互相都需要看懂的，所以这个时候注释就更利于团队之间的交流合作和代码的拼接。

注释代码可以方便找出代码的bug。很多时候我们的代码无法运行，这个时候我们就可以通过注释的方法来看哪一行代码出了问题，这样更利于检查代码的bug。