大项目中的多行注释JSDoc标签

1、需求：写项目的时候，有一些很久之前的代码经常忘了有啥功能，用//写注释吧，多个地方用也要多个地方去写，十分麻烦，今天看别人项目时发现别人用的是@param来写的注释，只要定义变量或方法时注释，在其他地方使用鼠标移上去就能看到注释，十分方便

 

 2、使用：方法很简单在你定义的变量前使用多行注释（复杂的注释格式可参照jsdoc：https://jsdoc.app/）

/**
  * @description: 描述
  * @param{类型}参数名1 Must
  * @param{类型}参数名2 Optional
  * @returns{类型}
*/

3、跟注释相关的一个库，感觉在比较大且复杂的项目中可以用到：jsdoc

JSDoc是一个根据javascript文件中注释信息，生成JavaScript应用程序或库、模块的API文档 的工具。你可以使用他记录如：命名空间，类，方法，方法参数等。类似JavaDoc和PHPDoc。现在很多编辑器或IDE中还可以通过JSDoc直接或使用插件生成智能提示。从而使开发者很容易了解整个类和其中的属性和方法，并且快速知道如何使用，从而提高开发效率，降低维护成本。