听说docstring for python这个插件蛮好用的,也确实蛮好用的,可以自动生成函数注释模板信息。但我觉得官方文档有点绕,网络上也没有中文版本的文档,这里分享一下怎么配置。
配置模板文件
首先安装插件,根据官方文档autoDocstring/google.mustache at master · NilsJPWerner/autoDocstring · GitHub,需要配置一个.mustache文件。这个文件用于控制生成的注释模板。一般来说用这个模板就够了,具体看这里。github.com
配置路径
然后需要设置该文件的路径为customTemplatePath。在vscode中Shift+Ctrl+P,输入setting,打开设置。搜索customTemplatePath,输入文件路径即可
按shift+ctrl+2即可生成
特殊情况
值得一提的是,在另外一台电脑上,我按这个模板怎么配置都无法显示参数信息,类似这样
把模板里
{{#parametersExist}}和{{/parametersExist}}分别改成
{{#argsExist}}和{{/argsExist}}就OK了