pycharm注释出错的原因是什么

本文教程操作环境：windows7系统、Python 3.9.1，DELL G3电脑。

很多人喜欢买一个标签条用来给要点写标注，单独的标签页面也非常显眼。在pycharm中也有类似的注释操作需要我们去进行，有一些小伙伴学习了pycharm注释后去定义函数问题，但是发现不能进行备注。今天我们就pycharm在函数中的注释方法和出错的解决问题统一整理出来，有相关需求的小伙伴可以看看。

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

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

deff(b,c):
'''

输出结果为

defa(b,c):
'''
:paramb:
:paramc:
:return:
'''

如果是输入输出解释的话，在def()的下面一行（注意缩进）输入三个双引号然后回车

defxxx(self,x1,x2,x3):
"""

:paramx1:
:paramx2:
:paramx3:
:return:
"""

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

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