我们将在本节中介绍 Python 语句,缩进以及注释,在本节的最后一部分,还会介绍作为一种特殊类型的 Python 注释 Docstring 。
创新互联主要从事网站设计、做网站、网页设计、企业做网站、公司建网站等业务。立足成都服务荆门,10余年网站建设经验,价格优惠、服务专业,欢迎来电咨询建站服务:028-86922220
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 介绍了函数的功能。
1、Python 中单行注释以 # 开头
例如:
# 这是个注释
print("Hello, World!")
或者:
print("Hello, World!") # 这是个注释,放在一行的最后
2、多行注释用三个单引号 ''' 或者三个双引号 """ 将注释括起来
例如:
'''
这是多行注释
这是多行注释
'''
print("Hello, World!")
或者:
"""
这是多行注释
这是多行注释
"""
注释,确保对模块、函数、方法和行内注释使用正确的风格。
python中的注释有单行注释和多行注释:
1、单行注释(行注释)
python中使用#表示单行注释。单行注释可以作为单独的一行放在被注释代码行之上,也可以放在语句或表达式之后。
比如:
# 这是一个注释
print("Hello, World!")
①当单行注释作为单独的一行放在被注释代码行之上时,为了保证代码的可读性,建议在#后面添加一个空格,再添加注释内容。
②当单行注释放在语句或者表达式之后时,同样为了保证代码的可读性,建议注释和语句之间至少要有两个空格。
2、多行注释(块注释)
当注释内容过多,导致一行无法显示时,就可以使用多行注释。多行注释用三个单引号'''或者三个双引号 """将注释括起来。
①单引号(''')
'''
这是多行注释,用三个单引号
这是多行注释,用三个单引号
这是多行注释,用三个单引号
'''
print("Hello, World!")
②双引号(""")
"""
这是多行注释,用三个双引号
这是多行注释,用三个双引号
这是多行注释,用三个双引号
"""
print("Hello, World!")
3、注意
①注释不是越多越好,对于一目了然的代码,不需要添加注释;
②对于复杂的操作,应该在操作开始前写上相应的注释;
③对于不是一目了然的代码,可以在代码之后添加注释;
④绝对不要描述代码,一般阅读代码的人都了解python的语法,只是不知道代码要干什么。
python三种注释方法:
方式1:
单行注释:shift + #(在代码的最前面输入,非选中代码进行注释)。
多行注释:同单行一样在每一行的前面输入shift + #。
相关推荐:《Python视频教程》。
方式2:
单行和多行一样的方式:Ctr+ /(前提是选中需要注释的代码)。
方式3:
输入''' '''或者""" """,将要注释的代码插在中间。
Python注释好处:
增强代码的可读性。由于个人编码的习惯不同,可能我们自己写的代码不是所有人都能读懂。但是这在团队合作的项目里又是必须互相都需要看懂的,所以这个时候注释就更利于团队之间的交流合作和代码的拼接。
注释代码可以方便找出代码的bug。很多时候我们的代码无法运行,这个时候我们就可以通过注释的方法来看哪一行代码出了问题,这样更利于检查代码的bug。
signature(callable),获取签名(函数签名抱哈了一个函数的信息,包括函数名,它的参数类型,所在的类和名称空间及其他信息。)
inspect.isfunction(add) 是否是函数
inspect.ismethod(add) 是否是类的方法
inspect.isgenerator(add) 是否是生成器对象
inspect.isgeneratorfunction(add) 是否是生成器函数
inspect.isclass(add) 是否是类
inspect.ismodule(add) 是否是模块
inspect.isbuiltin(print) 是否是内建函数
自定义函数是这样做注解的
def add(x:int,y:int)-int:
return x+y
函数引用类型不用注解 由被引用的函数注解