利用PyCharm生成类似于Pytorch的高质量注释

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/u013859301/article/details/80610154

在学习pytorch时,无意间发现pytorch的注释写的非常详细。在pycharm中,输入函数名后直接按Ctrl+Q即可快速打开注释窗口。随便贴几个感受一下:
这里写图片描述
这里写图片描述

可以看到,不仅可以在注释中添加参数表格、说明、examples,还可以插入图片、超链接和类型等信息。
其实他们是用了谷歌的python docstring format。只需要在pycharm中稍微设置一下,便可以自动生成这种注释模板。

具体方法为:
File->Settings->Tools->Python integrated Tools->Docstring format,把该框选为Google即可。

使用时,每完成一个函数,换行后打三个双引号,然后回车即可自动生成Google参数模板,我们只需要补全内容即可。

猜你喜欢

转载自blog.csdn.net/u013859301/article/details/80610154