首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >来让人工智能帮你写注释吧,支持 Python

来让人工智能帮你写注释吧,支持 Python

作者头像
somenzz
发布2022-04-07 20:12:34
发布2022-04-07 20:12:34
1.1K0
举报
文章被收录于专栏:Python七号Python七号

关于代码的注释,我自己也是很少写,但是时间一长,连自己都要看很久才知道啥意思,要让别人看明白,更是耗费时间了。

为什么写代码不写注释,主要原因还是因为懒,懒得思考怎么写。不过今天发现一个 VSCode 的插件,可以让 AI 帮你写注释了,写的清清楚楚明明白白。

只要选中函数代码,然后按一个快捷键就会自动生成该方法的注释,可用来生成函数文档。

看下效果
代码语言:javascript
复制
from typing import List
def daily_avg(temps: List[float]) -> float:
    return sum(temperatures)/len(temperatures)

比如上面这样的函数,生成的注释效果如下:

代码语言:javascript
复制
from typing import List

def daily_avg(temps: List[float]) -> float:
    """
    Given a list of temperatures, return the average of the temperatures
    
    :param temps: a list of floats
    :type temps: List[float]
    :return: The average of the temperatures.
    """
    return sum(temperatures)/len(temperatures)

看来 AI 完全知道你在写什么,有点可怕,不过总比让我自己写好,还要考虑怎么翻译成英文,哈哈。

快捷键
  • Windows 和 Linux :Ctrl + Alt + .
  • Mac:⌘ + .
安装方法

浏览器只要打开这个链接 AI Doc Writer[1],然后点击 install 就可以安装到 VSCode 了。

其他

它支持多种语言 JS、TS、Java、Python、PHP 等,有 VScode、IntelliJ 等插件版本,还可以在线试用[2]。 参考资料

[1]

AI Doc Writer: https://marketplace.visualstudio.com/items?itemname=mintlify.document

[2]

在线试用: https://www.docstring.ai

本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2022-03-16,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 Python七号 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 看下效果
  • 快捷键
  • 安装方法
  • 其他
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档