解决Pycharm不能自动生成函数注释

为了解决Pycharm不能自动生成函数注释，来看看怎么操作吧

PyCharm在定义函数之后，可以自动生成包括参数和返回值在内的注释，具体使用方法为：

函数定义后，另起一行，输入三对引号（单引号和双引号均可），后回车

1
2

def f(b,c):
'''

输出结果为

1
2
3
4
5
6

def a(b,c):
    '''
    :param b:
    :param c:
    :return:
    '''

但是，最近在使用的时候发现，定义函数之后不能按照此方法自动生成注释。查阅资料发现，原来是 PyCharm 的设置问题，解决方法如下

按照如上1-4的步骤，即在 File -> Settings -> Tools -> Python Integrated Tools -> Docstrings -> Docstring format 中将 Docstring format 改为 reStructuredText，此处如果是plain就导致定义函数之后不能自动生成注释