Python基础之注释的用法

前言

Python代码的基本规范如下:

1、Python 文件将以 .py 为扩展名。

2、在Python中严格区分大小写(大小写敏感),如果写错了大小写,程序会报错。

3、Python中的每一行就是一条语句,每条语句以换行结束,不用;分号结束。

4、Python是缩进严格的语言,所以在Python中不要随便写缩进。

  • 缩进的好处是强迫你写出缩进较少的代码,你会倾向于把一段很长的代码拆分成若干函数,从而得到缩进较少的代码。
  • 缩进的坏处就是复制-粘贴功能失效了,当你重构代码时,粘贴过去的代码必须重新检查缩进是否正确。

5、一条语句可以分多行编写,多行编写时语句后边以结尾 。

6、Python中每一行语句不要过长(规范中建议每行不要超过80个字符)。

扩展:

Python中文文档地址:https://docs.python.org/zh-cn/3/index.html。关于代码规范:
Python 官方提供有一系列 PEP(Python Enhancement Proposals) 文档,其中第 8 篇文档专门针对 Python 的代码格式 给出了建议,也就是俗称的 PEP 8。
文档地址:https://www.python.org/dev/peps/pep-0008/。

一、注释的作用

通过使用自己熟悉的语言,在程序中提示或解释某些关键代码的思路、作用和功能等,能够大大增强程序的可读性。(代码的可读性是非常重要的)

代码注释效果如下图:

没有添加注释的代码。

添加注释的代码。

二、注释的分类

注释分为两类:单行注释 和 多行注释。

单行注释

#作为单行注释的符号。只注释一行内容,语法如下:

# 注释内容

多行注释

可以注释多行内容,常用来为 Python 函数、类、模块等等添加功能、版本和作者等描述信息, 语法如下:

#写法一:一对三双引号
"""
  第一行注释
  第二行注释
  第三行注释
"""

#写法二:一对三单引号
'''
  注释1
  注释2
  注释3
'''

三、注释的注意事项

Python 解释器(Python Interpreter)在执行程序(代码)时会忽略注释部分,不做任何处理。
当Python解释器解析Python文件的时候,一旦发现出现了#,就会认为#右边的文字全部都是说明性的文字,Python的解释器会直接跳过这一行,解释下一行代码。

极简单的注释可以放到一行代码的后面,一般习惯代码后面添加两个空格,再书写注释文字。

print('hello Python')  # 输出

#号和注释之间需要加上一个空格,不是强制,是规范。

Python 多行注释不支持嵌套,如下所示为错误写法:

'''
外层注释
    '''
    内层注释
    '''
'''

多行注释符号'''"""也可以作为字符串的开始和结束标记。
Python 中当多行注释符号作为字符串的一部分出现时,就不能再将它们当做多行注释标记,而应该看做是字符串的一部分,如下所示:

#方式一
print("hello world ! hello python !")
print('hello world !')
print("""真香""")
print('''是真的''')

#方式二
str1 = "hello world ! hello python !"
str2 = 'hello world !'
str3 = """真香"""
str4 = '''是真的'''
print(str1)
print(str2)
print(str3)
print(str4)

"""
#执行结果都是
hello world ! hello python !
hello world ! 
真香
是真的
"""

四、什么时候需要使用注释

  • 注释不是越多越好,对于一目了然的代码,不需要添加注释。
  • 对于 复杂的操作,应该在操作开始前写上若干行注释。
  • 绝不要描述代码,假设阅读代码的人比你更懂 Python,他只是不知道你的代码要做什么,代码注释要做功能性描述。

在一些正规的开发团队,通常会有 代码审核 的惯例,就是一个团队中彼此阅读对方的代码。

五、总结

注释是一个程序员必须要具有的良好编程习惯。

注释的作用有两个:

  • 说明代码。
  • 调试程序。

注释快捷键

  • 单行注释:ctrl + /
  • 多行注释:没有,只能选中多行,在ctrl + /

到此这篇关于Python基础之注释的用法的文章就介绍到这了,更多相关Python注释内容请搜索179885.Com以前的文章或继续浏览下面的相关文章希望大家以后多多支持179885.Com!

猜你在找的Python基础之注释的用法相关文章

今天给大家带来的是关于Python的相关知识,文章围绕着Python注释的用法展开,文中有非常详细的介绍及代码示例,需求的大佬可以参考下
今天给大家带来的是关于Python的相关知识,文章围绕着OpenCV实现猫脸检测展开,文中有非常详细的介绍及代码示例,需求的大佬可以参考下
介绍了在Linux下使用命令行安装Python,通过详细的图文介绍Linux安装Python的全部过程,希望对你有所帮助
今天给大家带来的是关于Python的相关知识,文章围绕着为什么Python不用设计模式展开,文中有非常详细的介绍及代码示例,需求的大佬可以参考下
今天给大家带来的是关于Python函数的相关知识,文章围绕着python中readlines函数的参数hint展开,文中有非常详细的介绍及代码示例,需求的大佬可以参考下
ansible是基于 paramiko 开发的,并且基于模块化工作,本身没有批量部署的能力,接下来通过本文给大家分享python ansible自动化运维工具的特点及执行流程,感兴趣的朋友
今天带大家了解一下能让Python提速超40倍的神器,文章围绕着神器Cython展开,文中有非常详细的介绍及代码示例,需求的大佬可以参考下
在上一篇讲了几个常用的“Pandas”函数之后,今天小编就为大家介绍一下在数据统计分析当中经常用到的“Pandas”函数方法,希望能对大家有所收获,需求的大佬可以参
最近打算在win系统下使用pycharm开发程序,并远程连接服务器调试程序,其中在import tensorflow时报错,本文就来介绍一下如何解决,感兴趣的可以了解一下
本文主要介绍了在pycharm下调用tensorflow库时会出现的问题,在本文做个小结,也给自己留个笔记,感兴趣的可以了解一下
我比较喜欢看公众号,有时遇到一个感兴趣的公众号时,都会感觉相逢恨晚,想一口气看完所有历史文章。本文主要介绍了使用Python获取公众号下所有的文章,感兴趣的可以了解
介绍了python实现不同电脑之间视频传输,本文视频传输实现的前提是确保发送端和接收端接在同一个局域网下,分为发送端和接收端,通过实例代码给大家介绍的非常详细,需