本文内容主要介绍了Python代码注释规范代码实例解析,通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下！！！
一、代码注释介绍
注释就是对代码的解释和说明，其目的是让人们能够更加轻松地了解代码。
注释是编写程序时，写程序的人给一个语句、程序段、函数等的解释或提示，能提高程序代码的可读性。
在有处理逻辑的代码中，源程序有效注释量必须在20％以上。
二、代码注释分类
行注释：在符号后那一行不会被编译（显示）
块注释：被块注释符号中间的部分不会被编译
三、python代码注释基础
Python中使用#表示单行注释。单行注释可以作为单独的一行放在被注释代码行之上，也可以放在语句或表达式之后。如下例子：
name = 'xiaohong' # 单行注释
# 单行注释name = 'xiaohong'
Python中使用三个单引号或三个双引号表示多行注释。用在注释多写不下的情况，如下例子：
'''这是使用三个单引号的多行注释'''
"""这是使用三个双引号的多行注释"""
四、DocStrings介绍与使用
4.1 DocStrings介绍
文档字符串
是一个重要工具，用于解释文档程序，帮助你的程序文档更加简单易懂
4.2 python中使用DocStrings
在函数体的第一行使用一对三个单引号 ''' 或者一对三个双引号 """ 来定义文档字符串。你可以使用 doc（注意双下划线）调用函数中的文档字符串属性。
【python学习交流群】
编写示例如下：
5.2 Google风格
5.3 Numpydoc (Numpy风格)
六、一些注释经验
注释不是越多越好。对于一目了然的代码，不需要添加注释。
对于复杂的操作，应该在操作开始前写上相应的注释。
对于不是一目了然的代码，应该在代码之后添加注释。
绝对不要描述代码。一般阅读代码的人都了解Python的语法，只是不知道代码要干什么
网友评论