安装DocBlockr插件：通过Package Control搜索并安装DocBlockr；2. 使用方法：在函数上方输入/**后回车，自动生成含参数、返回值的注释块；3. 配置优化：可设置快捷键、自定义模板及扩展语言支持，提升注释效率。
在Sublime Text中安装和使用DocBlockr插件，可以快速生成函数或方法的注释块，提升代码可读性和开发效率。下面详细介绍如何安装与配置DocBlockr，并用它自动生成注释。
安装DocBlockr插件
推荐通过Package Control来安装DocBlockr，这是Sublime Text最常用的插件管理工具。
- 确保已安装Package Control。如果没有，在浏览器打开https://www.php.cn/link/befa130dcb31961fa251d61e1e6ba0e1，按说明手动安装。
- 按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）打开命令面板。
- 输入“Install Package”，选择“Package Control: Install Package”并回车。
- 等待插件列表加载完成后，搜索“DocBlockr”，点击确认安装。
安装完成后无需重启，即可开始使用。
使用DocBlockr生成注释
DocBlockr支持多种语言（如JavaScript、PHP、Python等），在函数上方输入特定符号即可触发注释生成。
- 将光标放在函数定义的上方或空行上。
- 输入 /** 然后按回车，DocBlockr会自动识别下方函数的参数、返回值等信息。
- 例如，在JavaScript中写如下函数：
* 函数描述
* @param {string} name - 参数说明
* @returns {boolean} 返回值说明
*/
按Tab键可在各个占位符之间快速跳转，方便填写详细说明。
常用技巧和设置
为了更高效地使用DocBlockr，可以进行一些个性化设置。
- 修改触发方式：默认是输入 /** 后回车，也可在设置中启用“快捷键触发”。
- 自定义模板：打开菜单 Preferences → Package Settings → DocBlockr → Settings – User，添加JSON格式的配置，比如关闭某些提示或调整字段顺序。
- 支持语言扩展：虽然默认支持主流语言，但可通过正则匹配添加对新语言的支持。
- 实时预览：输入过程中会显示注释结构预览，帮助确认是否正确识别了函数签名。
基本上就这些。DocBlockr不复杂但容易忽略细节，熟练使用能显著提升写文档注释的效率。
