Vue DocBlocker是一款专为Vue开发者设计的扩展工具，旨在通过自动生成和完成文档块（DocBlock）来提高代码文档的效率和质量。无论您是新手还是经验丰富的开发者，Vue DocBlocker都能帮助您更快、更准确地编写文档。

主要功能：

• 自动补全： 在类、函数或类属性上方输入/**后，自动生成DocBlock代码片段。
• DocBlock连续输入： 在DocBlock中按下Enter键时，自动继续文档块的输入。
• 标签补全： 支持自动完成常用的DocBlock标签，如@param、@return和@throws。
• 类型推断： 从函数签名中推断参数和返回值类型，减少手动输入的工作量。
• 模板配置： 允许用户为不同类型的DocBlock配置自定义模板，以满足个性化需求。

配置选项：

Vue DocBlocker提供了丰富的配置选项，让您可以根据自己的需求调整文档生成的细节：

• vue-docblocker.gap：控制描述和标签之间的间隔。
• vue-docblocker.returnGap：在参数和返回值标签之间添加间隔。
• vue-docblocker.returnVoid：控制是否自动添加void返回类型。
• vue-docblocker.extra：添加额外的自定义标签。
• vue-docblocker.useShortNames：选择使用短类型名称或完整类型名称。
• vue-docblocker.qualifyClassNames：根据命名空间使用语句自动限定类名。
• vue-docblocker.author：设置默认作者标签。
• vue-docblocker.functionTemplate、vue-docblocker.propertyTemplate、vue-docblocker.classTemplate：自定义函数、属性和类的DocBlock模板。

模板自定义：

通过调整模板配置，您可以控制DocBlock的输出顺序和间隔设置。默认的函数模板配置如下：

{
    "message": {},
    "param": {},
    "return": {},
    "extra": {}
}

您可以根据需要添加间隔或自定义标签。例如：

{
    "message": {
        "gapAfter": true
    },
    "extra": {},
    "param": {
        "gapBefore": true
    }
}

支持的DocBlock标签：

Vue DocBlocker支持多种DocBlock标签，帮助您详细描述代码的功能和用途。常用标签包括：

• @param：描述函数参数
• @return：描述函数返回值
• @throws：描述可能抛出的异常
• @author：标识代码作者

通过Vue DocBlocker，您可以轻松生成符合标准的代码文档，提升开发效率和代码可读性。无论是团队合作还是个人项目，这款工具都能让您的Vue开发过程更加顺畅。