大家好，关于如何对自定义函数进行注释和说明（一）很多朋友都还不太明白，不过没关系，因为今天小编就来为大家分享关于的知识点，相信应该可以解决大家的一些困惑和问题，如果碰巧可以解决您的问题，还望关注下本站哦，希望对各位有所帮助！
这次我们就来说说在Power Query中编写自定义函数时如何做注释和解释。
在函数描述过程中，在变量后面添加as和变量类型。
例子：
让
总数=(x为数字，y为数字)=x+y
在
全部的
示例类型将出现在函数介绍的参数中。
让
总计=（x为数字，可选y）=x+y
在
全部的
应特别注意：
例子：
让
总数=(x为数字，可选y为数字)=x+y为数字
在
全部的
解释：
用户评论
讲得真棒！我一直在找教程讲解如何给函数添加文档注释，现在终于找到了！希望以后还能看到更多关于Python编码规范的文章，比如类型提示的使用等。
有9位网友表示赞同！
对于入门的小白来说这段文字可能有点难理解，建议可以加入一些详细的示例代码，这样更易于理解。
有10位网友表示赞同！
函数注释太重要了！这样其他人阅读你的代码会更加容易，也方便自己在未来的项目中回顾自己写的代码，节省很多调试时间。
有16位网友表示赞同！
我之前总是把函数注释当做多余的装饰，想不到它对代码的可读性影响这么大！从今天开始我要认真学习如何编写高质量的函数注释。
有8位网友表示赞同！
这个教程只说了添加备注和说明，并没有讲解哪些内容适合写进注释中。如果能够提供一些更有针对性的建议，比如注释应该表达什么，需要注意什么规范，我相信会更受欢迎。
有5位网友表示赞同！
我之前用的是Docstring格式，感觉这篇文章提出的方法更加简洁明了！看来这个方法更符合当下编码的趋势。
有7位网友表示赞同！
我觉得函数注释和代码本身一样重要，都需要清晰、简洁、易于理解。如果能把两个结合起来学习，效果会更好！
有15位网友表示赞同！
我写博客是用来分享经验教训的，所以我会把这篇教程分享到我的公众号上，希望能帮助更多人了解如何给自定义函数做注释。
有15位网友表示赞同！
这个方法虽然简单易行，但对于一些复杂的函数来说，可能无法全面表达其功能。我们需要结合不同的方法和工具，来实现更精细化的代码注释！
有13位网友表示赞同！
我一直觉得Python开发的代码注释规范化很有必要，希望会有更多的优秀教程能帮助大家提高代码质量。
有12位网友表示赞同！
我平时写代码的时候基本都会添加注释，但感觉这篇文章提供了一些新的思路，让我对函数注释有了更深入的理解！
有17位网友表示赞同！
学习一个新技术最好的方法就是反复实践，我现在就来试着给我的自定义函数添加注释，看看效果如何。
有18位网友表示赞同！
在某些情况下，虽然代码本身已经很清晰了，但仍然需要额外的注释来解释其背后的逻辑或者设计理念，这是非常重要的！
有9位网友表示赞同！
我感觉编程越来越像艺术创作一样，简洁、明了的代码可以是一种美学。而函数注释则能够更直观地提升代码的欣赏价值。
有6位网友表示赞同！
给自定义函数添加注释并不只是为了方便别人阅读，更是给自己留下线索，以便在以后回顾这段代码时能更轻松地理解它。
有18位网友表示赞同！
对于初学者来说，如何给函数做备注和说明，这篇文章内容讲解的非常清晰，受益匪浅！
有5位网友表示赞同！
我之前一直觉得函数注释只是一个繁琐的任务，没有想到它能够对一个项目的影响力那么大！
有9位网友表示赞同！
我希望以后能看到更多关于代码风格、注释规范等方面的文章，帮助我们写出更加高质量的代码。
有10位网友表示赞同！