Python类和方法注释规范

注释风格

reStructuredText（PyCharm默认）

def func(path, field_storage, temporary):
    '''基本描述
    详细描述
    :param path: The path of the file to wrap
    :type path: str
    :param field_storage: The :class:`FileStorage` instance to wrap
    :type field_storage: FileStorage
    :param temporary: Whether or not to delete the file when the File instance is destructed
    :type temporary: bool
    :returns: A buffered writable file descriptor
    :rtype: BufferedFileStorage
    '''
    pass

NumPy

def func(path, field_storage, temporary):
    '''基本描述
    详细描述
    Parameters
    ----------
    path : str
        The path of the file to wrap
    field_storage : FileStorage
        The :class:`FileStorage` instance to wrap
    temporary : bool
        Whether or not to delete the file when the File instance is destructed
    Returns
    -------
    BufferedFileStorage
        A buffered writable file descriptor
    '''
    pass

Google（官方推荐）

def func(path, field_storage, temporary):
    '''基本描述
    详细描述
    Args:
        path (str): The path of the file to wrap
        field_storage (FileStorage): The :class:`FileStorage` instance to wrap
        temporary (bool): Whether or not to delete the file when the File instance is destructed
    Returns:
        BufferedFileStorage: A buffered writable file descriptor
    '''
    pass

Sphinx对NumPy和Google风格的对比，英文不好可以参考中文版

小技巧

在PyCharm中Ctrl+Q可快速查看注释

代码规范（含代码注释）

代码缩进和冒号

注意条件语句必须严格控制缩进，保证父句和子句的关系

num = 10
if num>5:
    print('yes')
else:
    print('no')

空行分隔代码段

例如if语句判断、while循环、for循环、def函数、class类等代码段前后最好留一行（人工分好段落）

# if语句
if num>5:
    print('yes')
else:
    print('no')
 
# for循环
for i in (1,2,4):
    print(i)
 
# while循环
while i>3:
    print('yes')
    i+=1
else:
    print('end')
    
# 函数定义
def show():
    print(132)
 
# 类定义
class Person:
    def show(self):
        print(123)

包、模块的命名规范

1. 包——要求统一用小写（相当于文件夹）

2.模块——要求统一用小写（相当于文件夹里的文件）

类和对象的命名规范

1. 类——严格的驼峰式写法eg.IndexUserPerson

2. 对象——要求统一用小写

函数的命名规范

驼峰式写法 eg.indexUserPerson（不强行）

代码注释

1.单行注释——#

2.多行注释——（快捷键为Ctrl+/）

'''

三对单引号，python多行注释符''' 

免责声明：本站发布的内容（图片、视频和文字）以原创、转载和分享为主，文章观点不代表本网站立场，如果涉及侵权请联系站长邮箱：mmqy2019@163.com进行举报，并提供相关证据，查实之后，将立刻删除涉嫌侵权内容。

猜你喜欢

• Pandas urllib模块的用法及应用场景是什么

  这篇文章介绍了Python技能树共建之python urllib 模块，urllib模块是 Python 标准库，更多相关介绍需要的小伙伴可以参考下面文章的详细内容

• python怎样实现排序算法？

  python怎样实现排序算法？对于排序算法有冒泡排序、选择排序、插入排序和快速排序等，很多新手对于这些排序算法的实现可能不是很了解，对此，这篇文章就主要给大家分享排序算法的实现，感兴趣的朋友就继续往下看吧。

• 用numpy.mean怎样计算矩阵均值，代码是什么

  这篇文章主要介绍了numpy.mean() 计算矩阵均值方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教

• Python逆向抓取数据的实现环境及过程是什么

  今天给大伙分享一下 Python 爬虫的教程，这次主要涉及到的是关于某 APP 的逆向分析并抓取数据，关于 APP 的反爬会麻烦一些，比如 Android 端的代码写完一般会进行打包并混淆加密加固，所以除了抓包之外，还需要对 APP 进行查壳脱壳反编译等操作。

• Pandas数据分析中的核心操作包括哪些

  在本文中，作者从基本数据集读写、数据处理和 DataFrame 操作三个角度展示了 23 个 Pandas 核心方法，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪