在前端开发中，许多开发人员可能已经使用了不少 npm 包来简化开发流程。但是，您是否听说过名为 redoctor 的 npm 包呢？不行的话，就让本篇文章为您介绍它。
1. 安装的方式
在命令行中输入以下命令进行安装：
npm install redoctor
安装完成后，你可以使用以下命令进行版本检查：
redoctor -v
2. redoctor 的作用
redoctor旨在提供一种能够自动生成文档的方法，利用代码注释在项目中生成 API 文档。它基于 JSDoc 注释来生成 Markdown 格式或 HTML 格式的文档，并且自动生成基于 GitBook 的文档，并非常适用于 JavaScript 项目。
3. 使用方法
在项目中，通过注释代码的方式进行文档的生成。以下代码示例：
-- -------------------- ---- ------- --- - ------ - --------- ------- - --------- ---------- - ------ -------- --- - ---- - -------- -------- ------ - -------- - ----- ---- - ----------------- --
其中，注释的第一行为函数名称和描述；第二行为函数所属的命名空间（可省略）；第三行为参数的描述（使用 @param 标识符）；最后一行为函数使用的实际例子（使用 @example 标识符）。
继续，通过执行以下命令，即可生成 API 文档。
redoctor -o ./doc/api ./src
在此，我们把文档生成到了 ./doc/api 目录下，并指定了源代码目录为 ./src。
最后，再通过本地的浏览器打开生成后的 api 目录下的index.html文件，即可看到项目的 API 文档。
总结
至此，我们已经成功地使用 redoctor 生成了文档。使用 redoctor 可以让项目的代码文档简单直观、可读性更高，也方便其他开发者在项目接手时更快速地上手。 鉴于此，我们建议在进行前端开发时，使用 redoctor 生成代码文档。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600562e281e8991b448e067d