什么是 betterdocco
betterdocco 是一个 npm 包，它可以自动生成文件的文档注释，并结合 github 上的 wiki 页面，生成包含文档注释而不是代码的文档。
如何安装 betterdocco
我们可以使用 npm 来安装 betterdocco，命令如下：
npm install betterdocco -g
如何使用 betterdocco
基础用法
我们可以直接使用 betterdocco 命令来生成文档：
betterdocco <filename or directory>
上述命令中，<filename or directory> 参数表示要生成文档的文件或目录。
增加自定义模板
betterdocco 生成的文档默认模板可能并不符合我们的需求，但是我们可以通过增加自定义模板的方式来达到我们想要的效果。
我们可以在 github 上面创建 wiki 页面，并且在 wiki 页面上写上想要的文档模板，然后在代码注释中使用注释标记来连接代码和 wiki 页面上的模板。
例如，我们在 wiki 页面上写好如下模板：
<div class="my-template">
<h3>{{title}}</h3>
<p>{{description}}</p>
<pre>{{code}}</pre>
</div>在代码注释中使用如下注释标记：
-- -------------------- ---- ------- -- - ---- ---------- ------------ - --- ---- - - ------ -------- ------ ---- - ------ -------- ---- ---- - ------ -------- ------ ---- - - ------- -------- ---- --
上述代码中，{template: my-template} 表示这个注释使用的是 my-template 这个自定义模板。
更好的注释
betterdocco 可以根据注释中不同的标记来区分各个部分，实现更好的注释效果。
例如，我们可以使用 @params 标记来注释函数/方法的参数：
/*
* @doc
* @params {String} name 名称
* @params {Number} age 年龄
*
* @return {String} 描述
*/我们还可以使用 @type 标记来注释变量的类型：
/*
* @doc
* @type {Number}
*
* @desc 单价
*/
var price = 10;结论
betterdocco 是一个很有用的 npm 包，它可以帮助我们更好地生成文档注释，并且可以自定义模板和更好的注释效果。使用 betterdocco 可以提高代码的可读性和可维护性，建议大家尝试使用。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64395